Retry-After header

HTTP Retry-After 響應頭指示使用者代理在進行後續請求之前應該等待多長時間。此頭主要用於以下三種情況:

  • 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>

一個非負十進位制整數,表示收到響應後延遲的秒數。

示例

處理計劃停機

客戶端和伺服器對 Retry-After 頭的支援仍然不一致。然而,一些爬蟲和蜘蛛,如 Googlebot,會遵守 Retry-After 頭。將其與 503 響應一起傳送很有用,這樣搜尋引擎在停機結束後會繼續索引您的網站。

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

規範

規範
HTTP 語義
# field.retry-after

瀏覽器相容性

另見