レートリミット
API のレートリミット処理方法。
|
概要
BlueAI API はサービスの安定性を守るためにレートリミットを適用します。レートリミットを超過すると、API は 429 Too Many Requests レスポンスを返します。
レートリミットヘッダー
レートリミット情報はレスポンスヘッダーに含まれます:
| ヘッダー | 説明 |
|---|---|
| X-RateLimit-Limit | ウィンドウあたりの最大リクエスト数 |
| X-RateLimit-Remaining | 現在のウィンドウ内の残りリクエスト数 |
| Retry-After | リトライまでの秒数(429 の場合のみ) |
ベストプラクティス
- 429 レスポンスを受け取った場合は指数バックオフを実装してください
- API コールを減らすため、可能な場合はレスポンスをキャッシュしてください
- 個別リクエストの代わりに、利用可能な場合はバルクエンドポイントを使用してください
- ヘッダーをプロアクティブに監視してください
X-RateLimit-Remaining