cURL
Webhooks
웹훅 생성
새 웹훅을 등록합니다. 테스트 API 키에서 isTest를 생략하거나 true로 지정하면 같은 owner의 테스트 엔드포인트가 생성되고, isTest: false는 AUTH_FORBIDDEN을 반환합니다.
- 여러 웹훅 등록 가능
- 등록 시 서명 시크릿이 반환됩니다
중요: 시크릿은 이 응답에서만 확인 가능합니다. 안전하게 보관하세요.
웹훅 이벤트 타입
| 이벤트 타입 | 설명 |
|---|---|
order.antiAi.completed | Anti-AI 처리 완료 |
order.antiAi.failed | Anti-AI 처리 실패 |
order.watermarkEmbed.completed | 워터마크 삽입 완료 |
order.watermarkEmbed.failed | 워터마크 삽입 실패 |
order.watermarkExtract.completed | 워터마크 추출 완료 |
order.watermarkExtract.failed | 워터마크 추출 실패 |
서명 검증
웹훅 요청에는 X-MoriBiz-Signature 헤더가 포함됩니다.
서명은 등록 시 발급된 시크릿으로 HMAC-SHA256을 사용하여 생성됩니다.
const crypto = require('crypto');
const signature = crypto.createHmac('sha256', secret)
.update(JSON.stringify(payload))
.digest('hex');
재시도 정책
- 최대 3회 재시도
- 지수 백오프 (1초, 2초, 4초)
- 성공 응답: 2xx 상태 코드
테스트 웹훅 엔드포인트는 isTest를 true로 지정합니다. 테스트 API 키는 같은 owner의 테스트 엔드포인트만 관리할 수 있습니다.
POST
cURL
인증
외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 sk_ 접두사를 사용하고, 테스트 키는 sk_test_ 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.
본문
application/json
응답
웹훅 생성 성공