아키텍처mono
웹훅 수신기
외부 업체가 웹훅을 호출하면 검증 후 큐에 넣고, 워커가 DB를 갱신하는 구성도입니다.
이 템플릿으로 시작하기
에디터에서 열립니다. 가입 없이 SVG·PNG·임베드로 내보냅니다.
텍스트 코드
title: Webhook Receiver
theme: mono
node provider "Provider" [external]
node hook "Webhook endpoint" [function]
node queue "Queue" [queue]
node worker "Worker" [function]
node db "Database" [database]
hook right-of provider
queue right-of hook
worker below queue
db right-of worker
provider -> hook : "POST event" flow
hook -> queue : "verified"
queue -> worker
worker -> db : "update"템플릿 설명
외부 업체가 내 엔드포인트로 웹훅(POST 이벤트)을 보냅니다. 엔드포인트는 요청을 검증한 뒤 큐에 넣고 곧바로 응답합니다. 이후 워커가 이벤트를 처리해 DB를 갱신합니다.
먼저 검증하고, 빨리 응답하고, 실제 처리는 비동기로 한다는 웹훅 수신의 일반적인 원칙을 그대로 그림에 담았습니다. 이렇게 하면 업체 쪽에서 타임아웃으로 재전송하는 일이 줄어듭니다.
"Provider"를 결제 대행사나 Git 호스팅처럼 실제로 연동하는 서비스 이름으로 바꾸세요. 실패한 이벤트를 어떻게 보관하는지 보여 주려면 데드 레터 큐를 추가하면 됩니다.