Reentregas

Seu endpoint vai cair um dia — um deploy, uma janela de manutenção, um certificado vencido. A Amivu insiste, com espaçamento crescente, e deixa cada tentativa visível.

O que conta como falha

• Qualquer status fora da faixa 2xx, inclusive 3xx.
• Sem resposta em 10 segundos.
• Erro de conexão, DNS ou TLS.

O recuo

São 7 tentativas ao longo de cerca de oito horas. O último intervalo é longo de propósito: quem cai, cai por manutenção, e uma janela de manutenção típica não cabe em minutos.

Cada tentativa é uma linha própria no painel, com o status que voltou e o corpo da resposta. Um contador diria “falhou 4 vezes”; as linhas dizem que as três primeiras deram 502 e a quarta deu 200.

Quando desligamos o endpoint

Depois de 20 falhas seguidas, a Amivu desliga o endpoint e escreve o motivo. Um endereço que sumiu do ar consome a fila para sempre, e a fila é compartilhada com quem está no ar.

Ligar de novo, no painel, zera o contador — o endpoint volta com o placar limpo, em vez de cair na primeira falha seguinte.

Inspecionar e reenviar

No painel, em Desenvolvedores → Webhooks, cada endpoint mostra as entregas recentes. Abrir uma delas revela o que saiu e o que voltou:

Requisição      cabeçalhos (assinatura redigida) + corpo assinado
Resposta        status, cabeçalhos, corpo (2 KB) e duração

Reenviar cria uma tentativa nova com o mesmo evento — o id não muda, então a sua deduplicação continua valendo. Pela API:

curl "https://api.amivu.com.br/v1/webhooks/wh_01K7.../deliveries?status=failed" \
  -H "Authorization: Bearer $AMIVU_API_KEY"

Veja também Assinaturas.