Beatra

レート制限

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-Keykey 単位の上限 / 残り
X-RateLimit-Reset上限がリセットされるまでの秒数

429 の処理

{ "error": { "code": "rate_limited", "retryable": true } }
  • 429 の Retry-After ヘッダー(秒)に従って待ち、同一の Idempotency-Key でリトライします
  • レート制限の最も一般的な原因はバースト的な同時リクエストです。クライアント側でリクエストを平準化してください
  • 上限の引き上げが必要な場合:コンソールからお問い合わせいただくか、担当のアカウントマネージャーにご連絡ください

On this page