Retentativas

​

Política de retentativas

Se o seu servidor não responder com um status HTTP 2xx, a Accithus reenvia a notificação automaticamente com backoff exponencial. Após 10 tentativas sem sucesso, a entrega é marcada como exhausted (esgotada) e não será mais reenviada. O ciclo completo de retentativas cobre aproximadamente 40 horas.

​

Status de entrega

​

Resposta esperada

Sua aplicação deve:

• Responder com status HTTP 2xx (200, 201, 202, etc.)
• Responder em até 10 segundos — após esse tempo, a requisição é abortada e a tentativa marcada como falha
• Retornar o mais rápido possível

​

Boas práticas

​

Idempotência

O mesmo evento pode ser entregue mais de uma vez (em caso de timeout ou falha de rede). Use o campo id do payload como chave de idempotência para evitar processamento duplicado.

​

Tempo de resposta

Mantenha o tempo de resposta abaixo de 5 segundos. Se o processamento do evento é demorado:

1. Salve o evento em uma fila ou banco de dados
2. Responda 200 OK imediatamente
3. Processe o evento em background

​

Verificação de assinatura

Sempre valide a assinatura HMAC antes de processar qualquer evento. Isso garante que a notificação veio da Accithus e não foi adulterada.

​

Monitoramento

Monitore falhas de entrega. Se muitas notificações estão falhando, verifique:

• Se a URL está acessível publicamente
• Se o certificado SSL é válido
• Se o servidor responde em menos de 10 segundos
• Se o firewall permite conexões da Accithus