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
- Google Webmaster blog: How to deal with planned site downtime
503
(Service Unavailable)301
(Moved Permanently)