이벤트 · 웹훅 — 무슨 일이 생기면 알려 드려요
주문 체결, 인스턴스 시작·실패·종료, 배포 매수·오류, 노드 온라인·오프라인, 충전 확인 같은 일이 생기면 이벤트로 기록돼요. 대시보드의 「최근 활동」과 GET /v1/events 에서 보고, 웹훅을 걸어 두면 내 서버로 바로 POST 해 드려요(슬랙 알림·자동 재시작·비용 집계에 써요).
웹훅 걸기
- 설정 → 웹훅 → 「웹훅 추가」. https 주소를 넣고 받을 이벤트를 고르세요(비우면 전부).
- 만들면 서명 비밀(
whsec_…) 이 한 번만 보여요. 수신 서버에 저장하세요. - 「테스트」를 누르면
webhook.test이벤트가 바로 가고, 결과(HTTP 상태)가 표시돼요.
받는 쪽에서 할 일
본문은 JSON {id, type, label, object_type, object_id, data, created_at, org_id, webhook_id, api_version} 이고 헤더에 Rerent-Event(종류) · Rerent-Event-Id · Rerent-Signature: t=<epoch>,v1=<hex> 가 있어요. v1 은 HMAC-SHA256(secret, "<t>.<본문 그대로>") 이고 t 가 5분 안일 때만 받으세요. 2xx 를 돌려주면 배달 완료. 아니면 1·5·30분·2시간 뒤 다시 보내고 5회 뒤 포기해요(설정의 「배달 기록」에서 사유 확인).
이벤트 종류
| 종류 | 언제 |
|---|---|
order.filled · order.partially_filled · order.standing · order.cancelled | 내가 낸 주문의 결과(취소는 사용자·시간 경과·매물 없음) |
order.fill | 내가 올린 호가가 상대 주문으로 체결됨(공급자·재판매자에게 유용) |
instance.created · instance.running · instance.failed · instance.terminated | 인스턴스 생애주기 |
deployment.bought · deployment.error · deployment.scaled | 배포가 시간을 샀다 · 매물 없음/크레딧 부족 · 목표 변경 |
node.online · node.offline · node.assigned | 공급자 노드 상태 |
topup.confirmed · payout.paid | 충전 확인 · 출금 완료 |
webhook.test | 테스트 발송 |
이벤트 기록 API
GET /v1/events?type=instance.failed&limit=50 — 최근순, starting_after=evt_… 커서. 90일 보관.