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

BCD tables only load in the browser

Veja também