【えいちてぃーてぃーぴーよんにーきゅう】
HTTP 429(Too Many Requests) とは?
公開:
💡 「短い時間にリクエストを送りすぎ」とサーバーが知らせるHTTPの応答コード
📌 このページのポイント
- APIの連続呼び出しや大量の自動アクセスで、サービスの制限を超えたときに返る
- 回数や頻度の問題を示し、認証情報が足りない401や、要求を断る403とは意味が違う
- 待ち時間はRetry-Afterヘッダーや応答本文で知らせることがある。ヘッダーは付かない場合もある
サーバーは応答できているよ。429は「一定時間にリクエストを送りすぎた」という知らせなんだ。制限を超えた分を受け付けていない状態だね。
401や403とは何が違うの?
どれくらい待てば、また使えるの?
Retry-Afterヘッダーが付いていれば、その秒数か日時まで待とう。付けるかどうかはサーバー次第だから、ない場合は応答本文やサービスの資料を見るんだ。GitHubなら、制限がリセットされる時刻を独自のヘッダーで知らせているよ。
「1時間に50回まで」みたいな数え方も、429で決まっているの?
もっと詳しく知りたい人へ
429が返ってきたら、すぐに再試行してもいい?
すぐに繰り返すと制限が続き、サービスによっては連携の停止につながることもあります。Retry-Afterや制限のリセット時刻まで待ち、情報がない場合は再試行の間隔を少しずつ広げ、回数にも上限を設けます。GitHubのREST APIは、二次的な制限で待ち時間の情報がない場合、少なくとも1分待つよう案内しています。
まとめ:ざっくりこれだけ覚えればOK!
「HTTP 429」って出てきたら「送りすぎだから、少し待ってね」と思えばだいたいOK!
📖 おまけ:英語の意味
「429 Too Many Requests」 = リクエストが多すぎる
💬 2012年のRFC 6585で追加された応答コードだよ。「いつまでに何回」と数えるルールは、各サービスが決めるんだ。