在 HTTP 协议中,响应首部 Retry-After 表示用户代理需要等待多长时间之后才能继续发送请求。这个首部主要应用于以下两种场景:
- 当与 503 响应一起发送的时候,表示服务下线的预期时长。
- 当与重定向响应一起发送的时候,比如 301,表示用户代理在发送重定向请求之前需要等待的最短时间。
<table class="properties"> <tbody> <tr> <th scope="row">标头类型</th> <td>Response header</td> </tr> </tbody> </table>
语法
Retry-After: <http-date>
Retry-After: <delay-seconds>
指令
<http-date>- : 表示在此时间之后可以重新尝试。参见 Date 首部来获取 HTTP 协议中关于日期格式的细节信息。
<delay-seconds>- : 一个非负的十进制整数,表示在重试之前需要等待的秒数。
示例
对于计划内宕机时间的处理
不同的客户端与服务器端应用对于 Retry-After 首部的支持依然不太一致。不过,一些爬虫程序,比如谷歌的爬虫程序 Googlebot,会遵循 Retry-After 首部的规则。将其与 (Service Unavailable,当前服务不存在) 响应一起发送有助于互联网引擎做出判断,在宕机结束之后继续对网站构建索引。
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120
规范
浏览器兼容性
参见
- 503
- 301
- 如何处理计划中的网站关闭事件,载于 developers.google.cn(2011)
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
