웹훅 시작하기

폴링 대신 웹훅을 쓰면 서명·완료 같은 사건이 일어날 때 팩터리가 여러분의 서버로 즉시 POST를 보냅니다.

1. 수신 엔드포인트 준비

여러분 서버에 HTTPS POST를 받을 URL을 만듭니다. 본문은 JSON 이벤트 객체입니다.

2. 엔드포인트 등록

조직 설정 → 개발자 → 웹훅에서 URL과 받을 이벤트를 등록합니다. 등록 시 **서명 비밀키(whsec_...)**가 발급됩니다.

3. 빠르게 200 응답

받은 즉시 200을 반환하고, 무거운 처리는 큐로 넘기세요. 응답이 늦거나 2xx가 아니면 재시도됩니다.

POST https://your-server.com/webhooks/pactery
Content-Type: application/json
Pactery-Signature: t=1717..., v1=5a2f...

서명 검증은 서명 검증을 참고하세요.