문서
웹훅 API 레퍼런스
서명된 최소 1회 이벤트 전달과 기록 및 재전송
대상
인증이 필요한 10개 경로로 대상을 생성, 조회, 검사, 수정, 교체, 테스트, 삭제할 수 있으며, 설정과 전달 기록을 읽고 전달 한 건을 재전송할 수도 있습니다. 대상 필터는 계정에 활성화된 국가 및 데이터 계열 권리 범위 안에서만 적용됩니다. 웹훅 대상 한도는 Free 1, Basic 3, Pro 10입니다.
예측 이벤트
predictions 계열을 포함하는 수신 대상은 이벤트 거래가 중단되면 prediction.event.closed를, 이벤트가 정산되거나 무효화되면 prediction.event.settled를 받습니다. 각 알림은 이벤트당 최대 한 번 전송합니다. 본문에는 이벤트 상태가 담기며, 확률이나 적중 결과는 포함되지 않습니다.
서명 및 재시도
x-narwhal-signature를 timestamp + "." + raw_body에 대한 HMAC-SHA256으로 검증하세요. 전달은 최소 1회 보장됩니다. 영구적으로 처리한 후에만 2xx 응답을 반환하고, 전달 ID로 중복을 제거하세요.
기록 및 재전송
전달 기록에는 시도 상태와 응답 상태가 기록됩니다. 재전송은 동일한 불변 이벤트에 대해 새 전달을 생성합니다. 시크릿 교체에는 겹치는 기간이 있어 수신 측은 안내된 두 서명 중 어느 것으로든 검증할 수 있습니다.