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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome ? Edge Full support YesFirefox No support No
Notes
No support No
Notes
Notes See bug 230260.
IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile Full support YesFirefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: dgadelha
Última atualização por: dgadelha,