Retry-After

Retry-After 响应 HTTP 头指示用户代理在发出后续请求之前应等待多长时间。此标头主要用于三种情况

  • 当与 503(服务不可用)响应一起发送时,这表示服务预计将不可用多长时间。
  • 当与 429(请求过多)响应一起发送时,这表示在发出新请求之前应等待多长时间。
  • 当与重定向响应(例如 301(永久移动))一起发送时,这表示用户代理在发出重定向请求之前被要求等待的最短时间。
标头类型 响应标头
禁止的标头名称

语法

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅