Webhooks란 무엇인가요?
웹훅은 Mercateer 프런트오피스 이벤트를 실시간으로 사용자가 제어하는 URL로 푸시하므로 자체 시스템이 API 폴링 없이 반응할 수 있습니다. 각 전달은 HMAC으로 서명된 JSON 페이로드이며, 엔드포인트는 API 또는 대시보드에서 등록 및 관리됩니다. 전달 실패 시 백오프와 함께 재시도됩니다.
Webhooks으로 할 수 있는 일
몇 분 만에 설치
엔드포인트 생성하기
API 또는 [설정] > [개발자]에서 URL을 등록하고 구독할 이벤트를 선택하세요. Mercateer는 해당 엔드포인트의 서명 비밀키를 반환합니다. API 접근 권한은 Crew 및 Fleet 요금제에 포함되어 있습니다.
서명 검증하기
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
재시도를 멱등하게 처리하기
전달을 확인하기 위해 빠르게 2xx 응답을 반환하세요. 전달 실패 시 백오프와 함께 재시도되므로, 핸들러를 이벤트 ID 기준으로 구성해 중복을 무시하고 각 이벤트를 한 번만 처리하세요.
자주 묻는 질문
전체 스택과 호환됩니다
Mercateer는 이미 사용 중인 도구들과 동일한 프로토콜을 지원합니다.