【リトライアフター】
Retry-After とは?
公開:
💡 次のリクエストまでどれだけ待つかを、サーバーが伝えるHTTPの応答ヘッダー
📌 このページのポイント
応答に「Retry-After: 120」って書いてあった。何の数字?
「受け取ってから120秒たったら、次のリクエストを送ってね」という意味だよ。つまり2分待てばいいんだ。
数字じゃなくて、日付が書いてあることもあるの?
あるよ。「Fri, 31 Dec 1999 23:59:59 GMT」のようなHTTPの日時なら、その時刻まで待つんだ。日時はGMT、つまりUTCで書かれるから、日本時間に直すなら9時間足して読もう。
送りすぎの429のときだけ付くもの?
一時的な過負荷やメンテナンスを示す503でも使われるよ。そのときは、サービスを使えない見込みの時間を表すんだ。3xxのリダイレクトに付いた場合は、転送先へ進む前に待つ最短の時間になるよ。
Retry-Afterが付いていなかったら、どうすればいい?
もっと詳しく知りたい人へ
プログラムで読むとき、秒数と日時はどう見分ける?
値がすべて数字なら秒数、それ以外はHTTP-dateという日時として扱います。秒数は応答を受け取ってからの待ち時間、日時はその時刻(UTC)まで待つという意味です。HTTP-dateには推奨形式のほかに古い2つの形式があり、受け取る側は3つとも解釈できることが求められています。
まとめ:ざっくりこれだけ覚えればOK!
「Retry-After」って出てきたら「サーバーが教えてくれる、次に試すまでの待ち時間」と思えばだいたいOK!
📖 おまけ:英語の意味
「Retry-After」 = 後で再試行する
💬 retryは「再試行」、afterは「〜の後で」。「この時間が過ぎてから、もう一度試して」という意味の名前だよ。