Retry-After
在 HTTP 协议中,响应首部 Retry-After 表示用户代理需要等待多长时间之后才能继续发送请求。这个首部主要应用于以下两种场景:
- 当与
503 Service Unavailable响应一起发送的时候,表示服务下线的预期时长。 - 当与重定向响应一起发送的时候,比如
301 Moved Permanently,表示用户代理在发送重定向请求之前需要等待的最短时间。
| 标头类型 | 响应标头 |
|---|
语法
http
Retry-After: <http-date>
Retry-After: <delay-seconds>
指令
<http-date>-
表示在此时间之后可以重新尝试。参见
Date首部来获取 HTTP 协议中关于日期格式的细节信息。 <delay-seconds>-
一个非负的十进制整数,表示在重试之前需要等待的秒数。
示例
>对于计划内宕机时间的处理
不同的客户端与服务器端应用对于 Retry-After 首部的支持依然不太一致。不过,一些爬虫程序,比如谷歌的爬虫程序 Googlebot,会遵循 Retry-After 首部的规则。将其与 503 (Service Unavailable,当前服务不存在) 响应一起发送有助于互联网引擎做出判断,在宕机结束之后继续对网站构建索引。
http
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120
规范
| 规范 |
|---|
| HTTP Semantics> # field.retry-after> |
浏览器兼容性
参见
503 Service Unavailable301 Moved Permanently- 如何处理计划中的网站关闭事件,载于 developers.google.cn(2011)