Retry-After ヘッダー
HTTP の Retry-After レスポンスヘッダーは、ユーザーエージェントがフォローアップリクエストを行う前にどれくらい待つべきかを示します。
このヘッダーが使用される主なケースは 3 つあります。
503 Service Unavailableレスポンスで送信された場合、これはサービスが利用できないと予想される期間を示します。429 Too Many Requestsレスポンスとともに送信された場合、これは新しいリクエストを行うまでどれくらい待つかを示します。301 Moved Permanentlyのようなリダイレクトレスポンスとともに送信された場合、リダイレクトされたリクエストを発行する前にユーザエージェントが待機するように要求される最小時間を示します。
| ヘッダー種別 | レスポンスヘッダー |
|---|
構文
http
Retry-After: <http-date>
Retry-After: <delay-seconds>
ディレクティブ
<http-date>-
再試行する日付。HTTP の日付形式の詳細については
Dateヘッダーを参照してください。 <delay-seconds>-
レスポンスを受信してから遅延する秒数を示す負でない 10 進数の整数。
例
スケジュールされたダウンタイムの処理
クライアントとサーバー双方の Retry-After ヘッダーの対応は、まだ一貫していません。ただし、Googlebot のような一部のクローラやスパイダーは Retry-After ヘッダーを尊重します。503 レスポンスと共に送信すると便利です。これにより、ダウンタイムが終了したときに検索エンジンがサイトのインデックスを作成し続けるようになります。
http
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120
仕様書
| Specification |
|---|
| HTTP Semantics # field.retry-after |
ブラウザーの互換性
関連情報
503 Service Unavailable301 Moved Permanently- How to deal with planned site downtime - developers.google.com (2011)