API
/
웹훅 등록하기
웹훅 등록하기
애플리케이션 이벤트를 실시간으로 받기를 위하여 웹훅을 연결하세요.
웹훅 등록
이벤트가 발생할 때 웹훅을 통해 알림
)을 받을 수 있습니다.
(예:
ORDER.PROCESSED
전체 이벤트 목록은 웹훅 이벤트 섹션에서 확인할 수 있습니다.
새로운 이벤트 유형이 지속적으로 추가되며, 처리할 이벤트와 방법은 선택할 수 있습니다.
다만, 이벤트 리스너 구현 시 시스템이 정상적으로 작동하도록 유지해야 합니다.
이벤트가 발생하면 HTTP POST 요청이 설정된 웹훅 URL로 전송되어, 이에 따른 후속 작업을 할 수 있습니다.
< 동일 이벤트가 여러 번 처리되지 않도록 웹훅 핸들러의 멱등성을 유지하기를 권장합니다. >
웹훅 이벤트는 지정된 URL로 한 번 전달을 시도하며, 전달이 실패할 경우(타임아웃 또는 HTTP 응답 코드가 200이 아닌 경우) 최대 3회까지 지수적 백오프 알고리즘을 사용해 재시도됩니다. 이벤트는 생성된 즉시 실행됩니다.
< 재시도된 이벤트가 중복 처리되지 않도록 eventId를 멱등성 키로 사용하여 처리하는 것을 권장합니다. >
웹훅 등록은 MORI BIZ 대쉬보드에서만 가능합니다.
웹훅 보안 (선택 사항)
페이로드 검증
API 키가 설정되면, MORI는 웹훅 요청의 전체 본문을 사용해 HMAC SHA-256 알고리즘으로 해시 서명을 생성합니다. 이 서명은 hex로 인코딩되어 X-Mori-Signature 헤더에 포함된 채 요청과 함께 전달됩니다.
외부 퍼블릭 이미지를 불러와 Anti-AI 필터 적용
· 일치: 요청이 검증을 통과한 것입니다.
· 불일치: 요청이 전송 중 변조되었거나 위조되었을 가능성이 있습니다.
웹훅 이벤트
자원에 대한 중요한 변경 사항을 기록하기 위해 이벤트를 사용합니다. 이벤트가 생성되면 웹훅 호출을 통해 전달됩니다.
이벤트의 유형:
{{RESOURCE}}.{{EVENT}}
이벤트 유형
설명
ORDER.PROCESSED
워터마킹 주문 처리가 완료되면 발생합니다.
{
"eventId": "7dddea77-232c-4ae7-a880-ba9e11563762",
"eventType": "ORDER.PROCESSED",
"occuredAt": "2024-01-01T12:00:00.000Z",
"data": {
"orderId": 123456789,
"createdAt": "2024-01-01T11:00:00.000Z",
"updatedAt": "2024-01-01T12:00:00.000Z",
"status": "complete"
}
}
API
/
웹훅 등록하기
웹훅 등록하기
애플리케이션 이벤트를 실시간으로 받기를 위하여 웹훅을 연결하세요.
웹훅 등록
이벤트가 발생할 때 웹훅을 통해 알림
)을 받을 수 있습니다.
(예:
ORDER.PROCESSED
전체 이벤트 목록은 웹훅 이벤트 섹션에서 확인할 수 있습니다.
새로운 이벤트 유형이 지속적으로 추가되며, 처리할 이벤트와 방법은 선택할 수 있습니다.
다만, 이벤트 리스너 구현 시 시스템이 정상적으로 작동하도록 유지해야 합니다.
이벤트가 발생하면 HTTP POST 요청이 설정된 웹훅 URL로 전송되어, 이에 따른 후속 작업을 할 수 있습니다.
< 동일 이벤트가 여러 번 처리되지 않도록 웹훅 핸들러의 멱등성을 유지하기를 권장합니다. >
웹훅 이벤트는 지정된 URL로 한 번 전달을 시도하며, 전달이 실패할 경우(타임아웃 또는 HTTP 응답 코드가 200이 아닌 경우) 최대 3회까지 지수적 백오프 알고리즘을 사용해 재시도됩니다. 이벤트는 생성된 즉시 실행됩니다.
< 재시도된 이벤트가 중복 처리되지 않도록 eventId를 멱등성 키로 사용하여 처리하는 것을 권장합니다. >
웹훅 등록은 MORI BIZ 대쉬보드에서만 가능합니다.
웹훅 보안 (선택 사항)
페이로드 검증
API 키가 설정되면, MORI는 웹훅 요청의 전체 본문을 사용해 HMAC SHA-256 알고리즘으로 해시 서명을 생성합니다. 이 서명은 hex로 인코딩되어 X-Mori-Signature 헤더에 포함된 채 요청과 함께 전달됩니다.
외부 퍼블릭 이미지를 불러와 Anti-AI 필터 적용
· 일치: 요청이 검증을 통과한 것입니다.
· 불일치: 요청이 전송 중 변조되었거나 위조되었을 가능성이 있습니다.
웹훅 이벤트
자원에 대한 중요한 변경 사항을 기록하기 위해 이벤트를 사용합니다. 이벤트가 생성되면 웹훅 호출을 통해 전달됩니다.
이벤트의 유형:
{{RESOURCE}}.{{EVENT}}
이벤트 유형
설명
ORDER.PROCESSED
워터마킹 주문 처리가 완료되면 발생합니다.
{
"eventId": "7dddea77-232c-4ae7-a880-ba9e11563762",
"eventType": "ORDER.PROCESSED",
"occuredAt": "2024-01-01T12:00:00.000Z",
"data": {
"orderId": 123456789,
"createdAt": "2024-01-01T11:00:00.000Z",
"updatedAt": "2024-01-01T12:00:00.000Z",
"status": "complete"
}
}
API
/
Webhook
Webhook
Connect a webhook to receive application events in real time.
Webhook Registration
Receive notifications through a webhook when an event occurs.
(Example:
ORDER.PROCESSED
You can receive(
)
The complete list of events can be found in the Webhook Events section.
New event types are continuously added, and you can choose which events to handle and how to process them.
However, when implementing the event listener, make sure that the system remains stable and functions properly.
When an event occurs, an HTTP POST request is sent to the configured webhook URL, allowing you to perform subsequent actions accordingly.
It is recommended to ensure idempotency in your webhook handler to prevent the same event from being processed multiple times.
A webhook event is delivered once to the specified URL. If the delivery fails (due to a timeout or a non-200 HTTP response), the system retries up to three times using an exponential backoff algorithm. Events are triggered immediately upon creation.
It is recommended to use the eventId as an idempotency key to prevent duplicate processing of retried events.
Webhook registration is only available through the MORI BIZ dashboard.
Webhook Security (Optional)
Payload Verification
When an API key is configured, MORI generates an HMAC SHA-256 hash signature using the entire webhook request body.
This signature is hex-encoded and included in the X-Mori-Signature header of the request.
Applying the Anti-AI filter to external public images
· Match: The request has passed verification.
· Mismatch: The request may have been tampered with or forged during transmission.
Webhook Events
Events are used to record significant changes to resources. When an event is generated, it is delivered through a webhook call.
Event Types:
{{RESOURCE}}.{{EVENT}}
Event Type
Description
ORDER.PROCESSED
Occurs when a watermarking order has been completed.
{
"eventId": "7dddea77-232c-4ae7-a880-ba9e11563762",
"eventType": "ORDER.PROCESSED",
"occuredAt": "2024-01-01T12:00:00.000Z",
"data": {
"orderId": 123456789,
"createdAt": "2024-01-01T11:00:00.000Z",
"updatedAt": "2024-01-01T12:00:00.000Z",
"status": "complete"
}
}
Getting Started
Integration Guide