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

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

BCD tables only load in the browser

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