Skip to main content

웹훅

트랜잭션 이벤트 발생 시 등록된 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초
tip

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