【リトライアフター】

Retry-After とは?

公開:
💡 次のリクエストまでどれだけ待つかを、サーバーが伝えるHTTPの応答ヘッダー
📌 このページのポイント
待ち時間の書き方は2通り 秒数 Retry-After: 120 受け取ってから120秒(2分) たってから、次のリクエストを送る 日時 Retry-After: Fri, 31 Dec 1999 23:59:59 GMT 31 この日時(UTC)になるまで待つ 日本時間なら9時間足して読む 429・503などに付く。付けるかはサーバー次第
日時の値は1行のヘッダーです。図では幅に収めるため折り返しています。3xxのリダイレクトに付いた場合は、転送先へ進む前に待つ最短の時間を表します。
ひよこ ひよこ
応答に「Retry-After: 120」って書いてあった。何の数字?
ペンギン先生 ペンギン先生
「受け取ってから120秒たったら、次のリクエストを送ってね」という意味だよ。つまり2分待てばいいんだ。
ひよこ ひよこ
数字じゃなくて、日付が書いてあることもあるの?
ペンギン先生 ペンギン先生
あるよ。「Fri, 31 Dec 1999 23:59:59 GMT」のようなHTTPの日時なら、その時刻まで待つんだ。日時はGMT、つまりUTCで書かれるから、日本時間に直すなら9時間足して読もう。
ひよこ ひよこ
送りすぎの429のときだけ付くもの?
ペンギン先生 ペンギン先生
一時的な過負荷やメンテナンスを示す503でも使われるよ。そのときは、サービスを使えない見込みの時間を表すんだ。3xxのリダイレクトに付いた場合は、転送先へ進む前に待つ最短の時間になるよ。
ひよこ ひよこ
Retry-Afterが付いていなかったら、どうすればいい?
ペンギン先生 ペンギン先生
付けるかどうかはサーバー次第なんだ。応答本文やサービスの資料を確認しよう。たとえばGitHubのAPIは、制限がリセットされる時刻を独自のヘッダーで返し、情報がない場合は少なくとも1分待つよう案内しているよ。
もっと詳しく知りたい人へ

プログラムで読むとき、秒数と日時はどう見分ける?

値がすべて数字なら秒数、それ以外はHTTP-dateという日時として扱います。秒数は応答を受け取ってからの待ち時間、日時はその時刻(UTC)まで待つという意味です。HTTP-dateには推奨形式のほかに古い2つの形式があり、受け取る側は3つとも解釈できることが求められています。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「Retry-After」って出てきたら「サーバーが教えてくれる、次に試すまでの待ち時間」と思えばだいたいOK!
📖 おまけ:英語の意味
「Retry-After」 = 後で再試行する
💬 retryは「再試行」、afterは「〜の後で」。「この時間が過ぎてから、もう一度試して」という意味の名前だよ。

参考資料

← 用語集にもどる