Webhooks

Подписанные события, повторы, идемпотентная обработка — как безопасно принимать Webhooks Baynoy.

Ещё не запущено — домен api.baynoy.com не резолвится, поэтому примеры ниже сегодня не выполнятся. Они описывают контракт, к которому мы идём, и схемы на этой странице ещё могут измениться.

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.

← Документация