본문으로 건너뛰기

웹훅

트랜잭션 이벤트 발생 시 등록된 URL로 HTTP POST 요청을 전송합니다.

웹훅 등록​

대시보드 → 프로젝트 → 연동 → 웹훅에서 URL과 이벤트를 등록합니다.

이벤트 목록​

이벤트발생 시점
certificate.deployed인증서 컨트랙트 배포 완료
certificate.issued인증서 발급 완료
certificate.revoked인증서 폐기 완료
trace.deployed이력관리 컨트랙트 배포 완료
trace.item_created이력 아이템 생성 완료
trace.record_added이력 레코드 추가 완료
transaction.failed트랜잭션 실패

페이로드 예시​

certificate.issued​

{
  "event": "certificate.issued",
  "projectId": "e0000000-0000-0000-0000-000000000001",
  "payload": {
    "transactionId": "673a5d1e-...",
    "txHash": "0xabc123...",
    "certificateId": "8ce493b5-...",
    "method": "issue",
    "params": {
      "walletAddress": "0x1111...1111",
      "tokenUri": "https://kbaas-storage.kr.object.gov-ncloudstorage.com/certificates/.../metadata.json"
    }
  },
  "timestamp": "2024-01-01T00:00:00.000Z"
}

transaction.failed​

{
  "event": "transaction.failed",
  "projectId": "e0000000-0000-0000-0000-000000000001",
  "payload": {
    "transactionId": "fd89036f-...",
    "error": "insufficient gas"
  },
  "timestamp": "2024-01-01T00:00:00.000Z"
}

재시도 정책​

웹훅 전송 실패 시 최대 5회 Exponential backoff으로 재시도합니다.

시도대기 시간
1차 실패 후2초
2차 실패 후4초
3차 실패 후8초
4차 실패 후16초
5차 실패 후32초
팁

웹훅 수신 엔드포인트는 200 응답을 빠르게 반환하고, 실제 처리는 비동기로 진행하는 것을 권장합니다.