애플리케이션 이벤트를 실시간으로 받기를 위하여 웹훅을 연결하세요.

웹훅 등록

이벤트가 발생할 때 웹훅을 통해 알림 (예: ORDER.PROCESSED)을 받을 수 있습니다. 전체 이벤트 목록은 웹훅 이벤트 섹션에서 확인할 수 있습니다.

새로운 이벤트 유형이 지속적으로 추가되며, 처리할 이벤트와 방법은 선택할 수 있습니다. 다만, 이벤트 리스너 구현 시 시스템이 정상적으로 작동하도록 유지해야 합니다.

이벤트가 발생하면 HTTP POST 요청이 설정된 웹훅 URL로 전송되어, 이에 따른 후속 작업을 할 수 있습니다.

<aside> 💡

동일 이벤트가 여러 번 처리되지 않도록 웹훅 핸들러의 멱등성을 유지하기를 권장합니다.

</aside>

웹훅 이벤트는 지정된 URL로 한 번 전달을 시도하며, 전달이 실패할 경우(타임아웃 또는 HTTP 응답 코드가 200이 아닌 경우) 최대 3회까지 지수적 백오프 알고리즘을 사용해 재시도됩니다. 이벤트는 생성된 즉시 실행됩니다.

<aside> 💡

재시도된 이벤트가 중복 처리되지 않도록 eventId를 멱등성 키로 사용하여 처리하는 것을 권장합니다.

</aside>

웹훅 등록은 MORI BIZ 대쉬보드에서만 가능합니다.

웹훅 보안 (선택 사항)

페이로드 검증

• API 키가 설정되면, MORI는 웹훅 요청의 전체 본문을 사용해 HMAC SHA-256 알고리즘으로 해시 서명을 생성합니다. 이 서명은 hex로 인코딩되어 X-Mori-Signature 헤더에 포함된 채 요청과 함께 전달됩니다.
• 서명을 검증할 때는, 해당 해시 값을 X-Mori-Signature 헤더 값과 비교합니다:
  • 일치: 요청이 검증을 통과한 것입니다.
  • 불일치: 요청이 전송 중 변조되었거나 위조되었을 가능성이 있습니다.
• 예시 코드

웹훅 이벤트

자원에 대한 중요한 변경 사항을 기록하기 위해 이벤트를 사용합니다. 이벤트가 생성되면 웹훅 호출을 통해 전달됩니다.

이벤트의 유형:

{{RESOURCE}}.{{EVENT}}

   "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"
    }

} | |