A espera faz parte da resposta HTTP
O Retry-After é um cabeçalho de resposta HTTP que indica quanto tempo o cliente deve aguardar para fazer uma requisição posterior. Com o status 503 Service Unavailable, ele informa a duração esperada da indisponibilidade. O cliente precisa interpretar o cabeçalho e programar a espera, pois sua presença não pausa uma automação por si só.
O servidor pode informar um número inteiro de segundos ou uma data HTTP. A RFC 9110 define os dois formatos. Um valor numérico mede a espera a partir do recebimento da resposta. Uma data exige calcular o intervalo até o instante informado.
O que significa receber Retry-After: 120
Este exemplo didático mostra parte de uma resposta de um serviço temporariamente indisponível:
HTTP/1.1 503 Service UnavailableRetry-After: 120O cliente deve aguardar os 120 segundos indicados, equivalentes a dois minutos, para tentar novamente. O status explica por que a chamada falhou e o cabeçalho orienta a espera. Ao fim do intervalo, o serviço ainda pode retornar outro erro, então você precisa limitar as tentativas e registrar o resultado de cada chamada.
O status 429 Too Many Requests também pode trazer o cabeçalho quando o cliente excede um limite de requisições. A RFC 6585 permite essa indicação, mas não exige que toda resposta 429 a inclua.
Esperar e repetir são etapas diferentes
A espera informa quando tentar, mas a repetição exige examinar o efeito da chamada. Uma consulta pode ser repetida sem criar outro registro. Já uma requisição de criação pode duplicá-lo caso a primeira tentativa tenha sido aplicada.
A seção sobre métodos idempotentes explica essa diferença: repetir uma requisição idempotente tem o mesmo efeito pretendido de executá-la uma vez. Você precisa confirmar essa propriedade no método e no contrato da API antes de automatizar novas tentativas.
Dúvidas frequentes
Perguntas frequentes sobre Retry-After
- O Retry-After sempre contém segundos?
- O valor pode ser um inteiro não negativo em segundos ou uma data HTTP. Os segundos são medidos a partir do recebimento da resposta. A data indica um instante e exige um cálculo de espera compatível com o relógio usado pelo cliente.
- O cabeçalho também aparece em redirecionamentos?
- Uma resposta 3xx pode incluir o Retry-After para indicar a espera mínima sugerida até o cliente fazer a requisição ao destino do redirecionamento.
- É seguro repetir automaticamente uma requisição POST?
- O método POST não é idempotente por definição, então uma repetição pode duplicar a ação. A automação precisa de uma garantia documentada pela API, como uma chave de idempotência, ou confirmar que a tentativa anterior não foi aplicada.
Para continuar
Recursos relacionados
Documentação
RFC 9110: Retry-After
Definição dos formatos de Retry-After e de seu uso com indisponibilidade temporária e redirecionamentos.
Abrir recursoAplicação na formação
n8n Experts
Uma integração automatizada precisa interpretar o Retry-After e controlar as novas tentativas para evitar chamadas repetidas durante uma indisponibilidade.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.