Webhooks
웹훅
콘테스트 이벤트에 대한 실시간 알림 받기
웹훅
웹훅은 외부 서비스가 애플리케이션에서 이벤트가 발생할 때 Blitz Rocket으로 데이터를 전송할 수 있게 합니다. 사용자가 플랫폼에 가입할 때 자동으로 콘테스트 참가자를 생성하거나 구매가 이루어질 때 포인트를 부여하는 데 웹훅을 사용하세요.
웹훅 작동 방식
- 외부 시스템(예: Shopify, Stripe 또는 맞춤 백엔드)에 웹훅 URL을 구성합니다.
- 이벤트가 발생하면(가입, 구매) 시스템이 Blitz Rocket 웹훅 엔드포인트로 HTTP POST 요청을 보냅니다.
- Blitz Rocket이 이벤트를 처리하고 참가자를 생성 또는 업데이트하며 포인트를 부여합니다.
사용 가능한 웹훅 엔드포인트
| 웹훅 | 엔드포인트 | 용도 |
|---|---|---|
| 가입 | POST /api/webhooks/signup/:contestId | 외부 가입에서 참가자 생성 |
| 구매 | POST /api/webhooks/purchase/:contestId | 외부 상점에서 구매 추적 |
웹훅 보안
각 웹훅 연결에는 팀 설정에서 구성할 수 있는 비밀 키가 있습니다. 웹훅 요청을 보낼 때 요청 본문이나 헤더에 비밀 키를 포함하여 진위를 확인하세요.
지원되는 통합
Blitz Rocket은 다음 웹훅을 지원합니다:
- Shopify — 자동 주문 및 고객 웹훅
- Stripe — 결제 및 구독 웹훅
- 맞춤형 — HTTP POST 요청을 보낼 수 있는 모든 시스템
웹훅 vs API
| 기능 | 웹훅 | REST API |
|---|---|---|
| 방향 | 외부 → Blitz Rocket | 코드 → Blitz Rocket |
| 인증 | 웹훅 비밀 키 | API 키 |
| 사용 사례 | 이벤트 기반 자동화 | 필요 시 작업 수행 |
| 실시간 | 예 (푸시) | 아니요 (풀) |
자동화된 이벤트 기반 참가자 생성 및 구매 추적이 필요할 때는 웹훅을 사용하세요. 작업에 대한 세밀한 제어가 필요할 때는 REST API를 사용하세요.