レート制限

レート制限は、テナントのパフォーマンスを予測可能に保ちます。固定の 60 秒ウィンドウにわたって、API キーごとに適用されます。

ティア

ティア	リクエスト数 / 分
`standard`（デフォルト）	120
`elevated`	600

キーのティアと現在の予算は、GET /v1/auth/context（rate_limit_tier）および GET /v1/usage（rate_limit.limit_per_minute と rate_limit.remaining_per_minute）で報告されます。値をハードコードするのではなく、常にライブの値を読み取ってください。

制限を超えた場合

制限を超えたリクエストは、code: "RATE_LIMITED" とともに 429 を返します。バックオフし、ウィンドウがリセットされた後にリトライしてください。

制限内での設計

参照データをキャッシュし、全テーブルのポーリングよりも増分同期を優先してください。
ポーリングの代わりに、イベント駆動の更新には Webhook を使用してください。
429 ではバックオフし、一時的な失敗の後に並列のリトライストームを起こさないでください。
フィルター（search、status、module）を組み合わせて、取得量を減らしてください。

レート制限

レート制限は、テナントのパフォーマンスを予測可能に保ちます。固定の 60 秒ウィンドウにわたって、API キーごとに適用されます。

ティア

ティア	リクエスト数 / 分
`standard`（デフォルト）	120
`elevated`	600

制限を超えた場合

制限を超えたリクエストは、code: "RATE_LIMITED" とともに 429 を返します。バックオフし、ウィンドウがリセットされた後にリトライしてください。

制限内での設計

参照データをキャッシュし、全テーブルのポーリングよりも増分同期を優先してください。
ポーリングの代わりに、イベント駆動の更新には Webhook を使用してください。
429 ではバックオフし、一時的な失敗の後に並列のリトライストームを起こさないでください。
フィルター（search、status、module）を組み合わせて、取得量を減らしてください。