Parse Retry-After

Retry-After é o cabeçalho que o servidor usa para dizer quando vale a pena tentar de novo. Ele aparece junto de 429, quando você estourou o limite de requisições, de 503, quando o serviço está fora do ar temporariamente, e de 301/302 em alguns cenários de manutenção. O que confunde é que ele aceita dois formatos completamente diferentes no mesmo campo.

Pode vir como um número puro, e aí são segundos a partir de agora — "Retry-After: 120" quer dizer daqui a dois minutos. Ou pode vir como data HTTP completa, no estilo "Wed, 21 Oct 2026 07:28:00 GMT", e aí é um instante absoluto. Cole qualquer um dos dois e a página traduz: o número vira também minutos, e a data vira a quantidade de segundos que falta a partir deste momento.

Do lado do cliente, respeitar esse valor é o que separa um retry educado de um que piora a situação. Se o servidor pediu 120 segundos, tentar a cada 5 só aumenta a fila. E quando o cabeçalho não vem, o padrão razoável é backoff exponencial com jitter — um atraso que cresce a cada falha, com uma variação aleatória para evitar que todos os clientes voltem no mesmo instante.