Webhooks

Événements signés, nouvelles tentatives, traitement idempotent — comment consommer les webhooks Baynoy en toute sécurité.

Pas encore en service — api.baynoy.com ne résout pas, les exemples ci-dessous ne fonctionneront donc pas aujourd'hui. Ils décrivent le contrat que nous construisons, et les formes de cette page peuvent encore changer.

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