Webhooks

Eventos assinados, novas tentativas, processamento idempotente — como consumir os Webhooks da Baynoy com segurança.

Ainda não está no ar — api.baynoy.com não resolve, então os exemplos abaixo não vão funcionar hoje. Eles descrevem o contrato que estamos construindo, e os formatos desta página ainda podem mudar.

Signed, at-least-once

Events are signed (per-endpoint secret, timestamped signature with a tolerance window) and delivered at least once with exponential backoff. Verify the signature before trusting anything.

Process idempotently

Store the event id and skip duplicates; never treat delivery order as meaningful. Respond 2xx quickly and do real work asynchronously — slow endpoints get their connection closed.

Replay

The dashboard shows every delivery with response code and duration, and lets you replay an event with its original id — a replay never creates a new event.

← Docs