DevOps
Como uma API informa quanto tempo esperar por uma nova tentativa
O cabeçalho HTTP Retry-After aceita uma data ou um intervalo em segundos. O significado da espera depende também do código da resposta.
Paul Gomes
1 min de leitura
Uma integração consulta um serviço e recebe a indicação Retry-After: 120. A contagem começa quando o cliente recebe a resposta: deve esperar dois minutos antes de tentar novamente. Também é possível receber uma data completa no formato HTTP. Nesse caso, a aplicação calcula o intervalo entre o seu relógio e o instante informado pelo serviço.
A causa da pausa aparece em outra parte da resposta. Pelo padrão HTTP, um código 503 pode indicar indisponibilidade temporária, inclusive durante manutenção. Já o 429 indica que o usuário enviou requisições demais em determinado intervalo. Nesse segundo caso, o serviço pode incluir o tempo de espera. O protocolo permite que a resposta venha sem essa informação.
A distinção ajuda a interpretar um incidente. Se vários clientes voltam a consultar um serviço logo depois de receber 429, o painel de erros pode registrar uma sequência de recusas originada da mesma tarefa. Registrar o código, o horário da resposta e o valor original do cabeçalho permite reconstruir quando cada nova tentativa deveria acontecer. O prazo informado orienta o cliente. A disponibilidade na tentativa seguinte ainda depende do serviço.
Foto de capa, ilustrativa. Cronômetro analógico com mostrador circular e ponteiro de segundos. Crédito: Jeremyida002. Ficha da fotografia. CC BY-SA 4.0.
Fontes utilizadas
Quem escreve
Paul Gomes
Fundador da WYS. Escrevo sobre marcas, tecnologia e o futuro dos negócios.
Sobre o autorPróximo passo
Quer aplicar isso no seu negócio?
Consultoria de inteligência artificial, GEO/AEO e palestras. Atendimento online, para todo o Brasil.