API呼び出し制限
Vivoldiでは、すべてのお客様に最適なサービス環境を提供するため、プランごとにAPIの呼び出し制限を設けております。
制限を超えた場合、HTTP 429 (Too Many Requests)エラーが返されます。この応答が表示された場合は、しばらく時間を置いてから再度お試しください。
プラン別 API リクエスト上限
以下の表では、各プランごとの分単位・時間単位の API リクエスト上限を確認できます。
利用可能なリクエスト数はサービス規模やトラフィック状況によって異なり、安定したAPI運用を維持するためにレート制限ポリシーが適用されます。
| プラン | 分ごとの上限 | 時ごとの上限 | 統計API / 分 | 統計APIの同時リクエスト |
|---|---|---|---|---|
| Free | 30 | 600 | 基本上限の5% | — |
| Personal | 180 | 10,000 | 基本上限の5% | 1 |
| Premium | 300 | 15,000 | 基本上限の5% | 1 |
| Business | 480 | 25,000 | 基本上限の5% | 2 |
| Business Plus | 768 | 40,000 | 基本上限の5% | 2 |
| Enterprise | 1,200 | 60,000 | 基本上限の5% | 契約内容に応じて適用（基本：3） |
APIリクエスト上限超過時の対処方法
APIリクエスト上限を超過すると、HTTP 429（Too Many Requests）レスポンスが返されます。
安定したサービス運用を維持するため、以下の方法でリクエスト処理ロジックを構成することを推奨します。
1. リトライ処理の実装（Retry with Backoff）
429レスポンスを受信した場合は、一定時間待機した後に再試行するリトライ処理を実装してください。
短時間で繰り返しリクエストを送信するのではなく、Exponential Backoff 方式の利用を強く推奨します。
2. リクエスト頻度の最適化
同じデータを繰り返し取得する場合は、キャッシュ（Cache）を活用することで不要なAPIリクエストを削減できます。
大量処理を行う場合は、単一リクエストを繰り返すよりもバッチ処理の方が効率的です。
3. 高トラフィック環境への対応
継続的にAPI上限へ近づく環境では、上位プランや柔軟なリクエスト上限に対応した Business Plus・Enterprise プランの利用をご検討ください。
ビジネスプラス・エンタープライズ流動制限
Business Plus・Enterprise プランでは、固定されたAPI上限ではなく、月間リンク生成数に応じてAPIリクエスト上限が自動的に拡張される柔軟なスケーリング方式を採用しています。
大量のリンクを運用するマーケティングプラットフォーム、ECサービス、企業向け社内システムなどに最適化されており、高トラフィック環境にも柔軟に対応できるよう設計されています。
- 基本基準：月間10,000リンク作成
- サービスの安定性維持のため、最大拡張制限は基本制限の3.5倍までとさせていただきます。
例（エンタープライズプラン）
- 月10,000リンク → 分間1,200回 / 時間160,000回
- 月30,000リンク → 分間2,000回 / 時間100,000回
※ Webhookの呼び出し制限は、一般API制限の80%が適用されます。
※ 実際の制限値は契約条件やサービスポリシーにより異なる場合があります。より高い制限が必要な場合は、カスタマーセンターへお問い合わせください。