Retry-After

Retry-After заголовок HTTP ответа показывает, как долго клиент должен подождать перед последующим запросом. Есть три основных случая, в которых следует использовать этот заголовок:

  • Когда отправлен с кодом 503 (Service Unavailable), отображая примерное время, через которое сервис будет доступен.
  • Когда отправлен с кодом 429 (Too Many Requests), отображая, сколько ждать перед следующим запросом.
  • Когда отправлен с кодом переадресации (например, 301 (Moved Permanently)), отображает минимальное время, которое клиент должен подождать перед переадресацией.
Тип заголовка Ответный заголовок
Forbidden header name no

Синтаксис

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

Директивы

<http-date>

Дата, после которой пытаться ещё раз. За документацией к HTTP дате, обратитесь сюда: Дата.

<delay-seconds>

Неотрицательное число секунд, показывающее время ожидания перед новым запросом.

Примеры

Работа с запланированным временем простоя

Поддержка Retry-After реализована ещё не везде. Впрочем, некоторые боты, к примеру Googlebot, понимает заголовок Retry-After. В данном случае полезно отправлять его с кодом 503 (Service Unavailable), чтобы поисковики продолжили индексировать после простоя

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

Спецификации

Specification Title
RFC 7231, раздел 7.1.3: Retry-After Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Совместимость с браузерами

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Retry-After

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Смотрите также