Retry-After

O cabeçalho de resposta HTTP Retry-After indica quanto tempo o agente de usuário deve aguardar antes de fazer outro pedido de acompanhamento. Existem dois casos principais em que este cabeçalho é usado:

  • Quando enviado com uma resposta 503 (Service Unavailable), indica quanto tempo o serviço deve ficar indisponível.
  • Quando enviado com uma resposta de redirecionamento, como 301 (Moved Permanently), indica o tempo mínimo solicitado que o agente de usuário aguarde antes de realizar o pedido de redirecionamento.
Tipo de cabeçalho Response header
Forbidden header name não

Sintaxe

Retry-After: <data-http>
Retry-After: <atraso-segundos>

Diretivas

<data-http>

Uma data para tentar novamente posteriormente. Veja o cabeçalho Date para mais detalhes sobre o formato de data HTTP.

<atraso-segundos>

Um decimal inteiro não-negativo indicando o tempo em segundos para esperar após a resposta ser recebida.

Exemplos

Lidando com uma indisponibilidade programada

O suporte para o cabeçalho Retry-After tanto em clientes quanto em servidores ainda é inconsistente. Apesar disto, alguns indexadores e robôs, como o Googlebot, honram o cabeçalho Retry-After. É útil enviá-lo junto com uma resposta 503 (Service Unavailable), assim, os mecanismos de busca poderão continuar indexando o seu site quando a indisponibilidade acabar.

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

Especificações

Especificação Título
RFC 7231, sessão 7.1.3: Retry-After Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Compatibilidade com navegadores

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.

Veja também