Skip to main content
POST
웹훅 등록
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
웹훅을 등록하여 특정 이벤트 발생 시 알림을 받습니다. 등록된 웹훅은 지정된 이벤트가 발생할 때마다 HTTP POST 요청을 전송합니다.
웹훅 URL은 HTTPS를 사용해야 하며, 공개적으로 접근 가능해야 합니다. 웹훅 요청은 HMAC-SHA256으로 서명됩니다.

Request Body 파라미터

string
required
웹훅 이벤트를 수신할 URL입니다. HTTPS만 지원됩니다. 최대 2048자입니다.
array
required
구독할 이벤트 목록입니다. 최소 1개 이상의 이벤트를 지정해야 합니다.
string
웹훅에 대한 설명입니다. 최대 200자입니다.
object
웹훅에 첨부할 메타데이터입니다. 키-값 쌍 형태입니다.

지원 이벤트


Response

성공

웹훅 등록에 성공하면 Webhook 객체가 반환됩니다. secret 필드는 생성 시에만 반환됩니다.

실패


요청 예시


응답 예시


Webhook 객체

secret은 웹훅 생성 시에만 반환됩니다. 이 값을 안전하게 저장하세요. 분실 시 웹훅을 삭제하고 다시 생성해야 합니다.

웹훅 페이로드

웹훅 이벤트가 발생하면 다음 형식의 페이로드가 POST 요청으로 전송됩니다.

서명 검증

모든 웹훅 요청에는 X-Bithumb-Signature 헤더가 포함됩니다. 이 서명을 검증하여 요청의 진위를 확인하세요.