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, section 7.1.3: Retry-After Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Compatibilidade com navegadores

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support ? Yes No1 ? ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support ? ? Yes ? ? ? ?

1. See Bug 230260.

Veja também

Etiquetas do documento e colaboradores

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