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.