Webhooks
ERROR
또는 FINISHED
상태에 도달했을 때 발생하는 statusChange
이벤트만 지원함.
Webhook 검증
Headers
X-Webhook-Signature
–sha256=<hex_digest>
형식의 HMAC-SHA256 서명X-Webhook-ID
– 이 전달에 대한 고유 식별자(로그에 유용)X-Webhook-Event
– 이벤트 타입(현재는statusChange
만)User-Agent
– 항상Cursor-Agent-Webhook/1.0
으로 설정
서명 검증
페이로드 형식
모범 사례
- 서명 검증 – 요청이 Cursor에서 왔는지 확인하려면 항상 웹훅 서명을 검증해
- 재시도 처리 – 엔드포인트가 오류 상태 코드를 반환하면 웹훅이 재시도될 수 있어
- 빠른 응답 – 가능한 한 빨리 2xx 상태 코드를 반환해
- HTTPS 사용 – 프로덕션 환경의 웹훅 엔드포인트에는 항상 HTTPS URL을 사용해
- 원본 페이로드 저장 – 디버깅과 추후 검증을 위해 웹훅 원본 페이로드를 저장해