웹훅 시작하기

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

1. 수신 엔드포인트 준비

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

2. 엔드포인트 등록

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

공개 인터넷에서 접근 가능한 **HTTPS URL(443 포트)**을 사용하세요. 사설·루프백·링크 로컬·예약 IP와 URL 내 인증정보는 허용하지 않습니다. 등록·변경 및 매 전송 시 DNS 주소를 확인하며, 리다이렉트는 따라가지 않습니다. 기존 HTTP 웹훅도 HTTPS 주소로 변경해야 전송됩니다.

3. 빠르게 200 응답

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

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

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