Create webhook

새 웹훅을 등록합니다.

• 여러 웹훅 등록 가능
• 등록 시 서명 시크릿이 반환됩니다

중요: 시크릿은 이 응답에서만 확인 가능합니다. 안전하게 보관하세요.

웹훅 이벤트 타입

이벤트 타입	설명
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 상태 코드

POST /api/v2/orders/webhooks

cURL

cURL

curl -X POST https://morimori.app/api/v2/orders/webhooks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Webhook",
    "url": "https://example.com/webhook"
  }'

200

{
  "data": {
    "id": 123,
    "name": "<string>",
    "secret": "<string>"
  }
}

Authorizations

Authorization · string · header · required

API Key for external client access

Body

application/json

url · string<uri> · required

Webhook endpoint URL

Example:

"https://example.com/webhook"

name · string

Webhook name (for identification)

Maximum string length: 100

Response

200

application/json

Webhook created successfully

data · object

Show child attributes