웹훅은 박스히어로에서 특정한 이벤트가 발생하였을 때, 실시간으로 알림을 받아볼 수 있는 기능입니다.
Webhook 등록
[결제 및 설정] - [외부 서비스 연동 & API] 메뉴에서 웹훅을 등록할 수 있습니다.
Webhook 핸들러
이벤트 발생시 등록된 Webhook Endpoint로 이벤트 본문을 전달합니다. webhook 핸들러 응답 status code가 200인 경우 정상적으로 수신하였다고 판단합니다. 만약 200이 아닌 status code가 반환되는 경우 일시적 에러로 간주하여 최대 3번까지 재시도 합니다.
이벤트 본문
이벤트 전달시 POST Body에 아래 데이터를 JSON 형태로 포함하여 전달합니다.
{"id":"1234",// 이벤트의 고유 ID"topic":"txs/new",// 이벤트 주제"version":1,// 이벤트 본문의 버전"payload": { // 이벤트 본문 ... }}