Skip to main content

​
Respostas HTTP recomendadas

  • 200: evento recebido/aceito com sucesso.
  • 400: payload inválido.
  • 401: autenticação do endpoint falhou.
  • 500: erro interno do receiver.

​
Comportamento atual do envio

No dispatch atual, o backend tenta enviar uma vez por evento/webhook e registra o status de resposta. Não há política de retentativa automática embutida nesse fluxo.

​
Estratégia recomendada no receiver

  1. Valide e persista rapidamente o payload.
  2. Responda 200 o quanto antes.
  3. Processe em fila/worker para reduzir timeout.
  4. Implemente idempotência (hash do payload ou chave composta por event + timestamp + identificador de negócio).

​
Diagnóstico de falhas

  • Verifique URL e certificado HTTPS.
  • Confirme headers customizados esperados.
  • Logue body e código de resposta para auditoria.