Digite para filtrar os verbetes do Glossário.

    Automação e integrações · n8n Experts

    O que é Retry-After?

    O Retry-After é um cabeçalho HTTP que indica a espera para uma nova requisição. Aceita segundos ou uma data e pode acompanhar erros 503 e 429 do servidor.

    Também chamado de: cabeçalho Retry-After

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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 Unavailable
    Retry-After: 120

    O 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

    Aplicaçã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
    Capa da formação n8n Experts

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano