Retry-After

Retry-After レスポンス HTTP ヘッダーは、ユーザーエージェントがフォローアップリクエストを行う前にどれくらい待つべきかを示します。このヘッダーが使用される主なケースは 3 つあります。

  • 503 (Service Unavailable) レスポンスで送信された場合、これはサービスが利用できないと予想される期間を示します。
  • 429 (Too Many Requests) レスポンスとともに送信された場合、これは新しいリクエストを行うまでどれくらい待つかを示します。
  • 301 (Moved Permanently) のようなリダイレクトレスポンスとともに送信された場合、リダイレクトされたリクエストを発行する前にユーザエージェントが待機するように要求される最小時間を示します。
ヘッダータイプ Response header
Forbidden header name いいえ

構文

Retry-After: <http-date>
Retry-After: <delay-seconds>

ディレクティブ

<http-date>

再試行する日付。HTTP の日付形式の詳細については Date ヘッダーを参照してください。

<delay-seconds>

レスポンスを受信してから遅延する秒数を示す負でない 10 進数の整数。

例

スケジュールされたダウンタイムの処理

クライアントとサーバーの両方で Retry-After ヘッダーがサポートされているのは、依然として矛盾しています。ただし、Googlebot のような一部のクローラとスパイダーは Retry-After ヘッダーを尊重します。503 (Service Unavailable) レスポンスと共に送信すると便利です。これにより、ダウンタイムが終了したときに検索エンジンがサイトのインデックスを作成し続けるようになります。

Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120

仕様

仕様書 タイトル
RFC 7231, セクション 7.1.3: Retry-After Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

ブラウザーの互換性

BCD tables only load in the browser

関連情報