レート制限
2 段階の固定ウィンドウ制限、X-RateLimit レスポンスヘッダー、429 の処理。
2 段階の固定ウィンドウカウンターでレート制限を行い、いずれか一方でも超過すると 429 になります:
| レベル | デフォルトの上限 | ウィンドウ |
|---|---|---|
| テナント単位 | 600 回/分 | 60s |
| API key 単位 | 120 回/分 | 60s |
実際の上限はアカウントの設定により異なります。レスポンスヘッダーの値が正です。
レスポンスヘッダー
すべてのレスポンスに含まれます:
| Header | 説明 |
|---|---|
X-RateLimit-Limit-Tenant / X-RateLimit-Remaining-Tenant | テナント単位の上限 / 残り |
X-RateLimit-Limit-Key / X-RateLimit-Remaining-Key | key 単位の上限 / 残り |
X-RateLimit-Reset | 上限がリセットされるまでの秒数 |
429 の処理
- 429 の
Retry-Afterヘッダー(秒)に従って待ち、同一のIdempotency-Keyでリトライします - レート制限の最も一般的な原因はバースト的な同時リクエストです。クライアント側でリクエストを平準化してください
- 上限の引き上げが必要な場合:コンソールからお問い合わせいただくか、担当のアカウントマネージャーにご連絡ください