Webhooks

署名付きイベント、リトライ、冪等な処理 — Baynoy Webhooksを安全に受け取る方法。

まだ公開していません — api.baynoy.com は名前解決されないため、以下のサンプルは現時点では実行できません。これから提供する仕様を示したもので、このページの形式は変更される可能性があります。

Signed, at-least-once

Each delivery carries Baynoy-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>"> made with the endpoint's whsec_ secret. Deliveries are at least once with backoff. Verify the signature, and that t is recent, 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.

Delivery log

Developers → Webhooks shows every delivery with its attempt number and response code, so a failing endpoint is visible rather than silent.