tool::http-status-detail
429 Too Many Requests
The user has sent too many requests in a given time (rate limiting).
ステータスコード
429
名前
Too Many Requests
カテゴリ
4xx詳細説明
HTTP 429 Too Many Requestsは、クライアントが指定された時間内に送信可能なリクエスト数を超えたことを示します。APIレート制限の標準レスポンスコードです。Retry-Afterヘッダーでいつ再リクエストできるかを通知できます。DDoS防御、API乱用防止、公平な利用確保のために使用されます。
主な原因
- ▸APIキーの分あたり・時間あたりのリクエスト上限を超過した場合
- ▸クローラーやスクレイパーが短時間に過剰なリクエストを送る場合
- ▸バックオフ戦略なしでループ内でAPIを繰り返し呼び出す場合
- ▸複数クライアントが同一IPを使用して上限を共有している場合
解決方法
- 1.Retry-Afterヘッダーの時間が経過してから再試行してください
- 2.指数バックオフ(Exponential Backoff)戦略を実装してください
- 3.APIキープランの上位等級へのアップグレードを検討してください
- 4.同一データの繰り返しリクエストを避けるためにレスポンスをキャッシュしてください
- 5.複数のAPIキーを使用してリクエストを分散してください(利用規約を要確認)
関連HTTPヘッダー
Retry-AfterX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Resetレスポンス例
HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1711900800
Content-Type: application/json
{"error":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}関連ステータスコード
400Bad RequestThe server could not understand the request due to invalid syntax.→401UnauthorizedAuthentication is required and has failed or not been provided.→402Payment RequiredReserved for future use; some services use it for payment walls.→403ForbiddenThe server refuses to fulfill the request (authenticated but unauthorized).→404Not FoundThe requested resource could not be found.→
ad · 300×250
// related tools