Webhooks

签名事件、重试、幂等处理——如何安全地接收和处理 Baynoy Webhooks。

尚未上线 —— 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.