【えいちてぃーてぃーぴーよんにーきゅう】

HTTP 429(Too Many Requests) とは?

公開:
💡 「短い時間にリクエストを送りすぎ」とサーバーが知らせるHTTPの応答コード
📌 このページのポイント
送りすぎたら、429で「少し待って」 アプリ APIサーバー 例:1分に5回まで 5/5 使用済み 6回目のリクエスト 429を返す 返ってきた応答(例) HTTP/1.1 429 Too Many Requests Retry-After: 30 (付かないこともある) 時間をおけば通る場合がある。認証の失敗とは別
上限の「1分に5回」は説明用の例です。誰の何をどう数えるかはサービスごとに決まり、429という番号だけでは分かりません。
ひよこ ひよこ
APIを何度も呼んでいたら「429」が返ってきた!サーバーが壊れたの?
ペンギン先生 ペンギン先生
サーバーは応答できているよ。429は「一定時間にリクエストを送りすぎた」という知らせなんだ。制限を超えた分を受け付けていない状態だね。
ひよこ ひよこ
401や403とは何が違うの?
ペンギン先生 ペンギン先生
401は有効な認証情報が足りない、403は要求を理解したうえで断ったという意味だよ。429は回数や頻度の問題なんだ。ただ、GitHubのAPIのように制限の超過で403を返すサービスもあるから、本文やヘッダーも確認しよう。
ひよこ ひよこ
どれくらい待てば、また使えるの?
ペンギン先生 ペンギン先生
Retry-Afterヘッダーが付いていれば、その秒数か日時まで待とう。付けるかどうかはサーバー次第だから、ない場合は応答本文やサービスの資料を見るんだ。GitHubなら、制限がリセットされる時刻を独自のヘッダーで知らせているよ。
ひよこ ひよこ
「1時間に50回まで」みたいな数え方も、429で決まっているの?
ペンギン先生 ペンギン先生
決まっていないよ。RFC 6585は、誰のリクエストをどう数えるかを定めていないんだ。ログインしたユーザーごと、ページごと、サーバー全体など、数え方はサービスによって違うよ。
もっと詳しく知りたい人へ

429が返ってきたら、すぐに再試行してもいい?

すぐに繰り返すと制限が続き、サービスによっては連携の停止につながることもあります。Retry-Afterや制限のリセット時刻まで待ち、情報がない場合は再試行の間隔を少しずつ広げ、回数にも上限を設けます。GitHubのREST APIは、二次的な制限で待ち時間の情報がない場合、少なくとも1分待つよう案内しています。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「HTTP 429」って出てきたら「送りすぎだから、少し待ってね」と思えばだいたいOK!
📖 おまけ:英語の意味
「429 Too Many Requests」 = リクエストが多すぎる
💬 2012年のRFC 6585で追加された応答コードだよ。「いつまでに何回」と数えるルールは、各サービスが決めるんだ。

参考資料

← 用語集にもどる