Blitz Rocket API 문서

Blitz Rocket API로 강력한 콘테스트 및 경품 통합 구축하기

소개

Blitz Rocket API를 사용하면 콘테스트, 참가, 보너스 액션 및 추천 추적을 프로그래밍 방식으로 관리할 수 있습니다. REST API를 사용하여 Blitz Rocket의 콘테스트 플랫폼을 기존 애플리케이션에 통합하고, 워크플로를 자동화하며, 맞춤형 경험을 구축하세요.

기본 URL

모든 API 요청은 다음 주소로 해야 합니다:

text
https://blitzrocket.com/api/v1

할 수 있는 일

  • 콘테스트 — 콘테스트 목록 조회 및 세부 정보, 분석, 리더보드 가져오기
  • 참가 — 참가 생성, 업데이트, 실격 처리 및 참가자 포인트 관리
  • 보너스 액션 — 콘테스트 참가에 대한 보너스 액션 조회 및 완료
  • 구매 — 콘테스트 참가와 연동된 구매 기록 및 추적
  • 리더보드 — 모든 콘테스트의 순위별 리더보드 가져오기
  • 분석 — 콘테스트 성과 지표 조회
  • 웹훅 — 가입 및 구매에 대한 실시간 알림 수신
  • 추천 추적 — 추천 링크를 통한 방문, 가입, 구매 추적

빠른 시작

  1. API 키 받기 — Blitz Rocket 대시보드의 팀 설정으로 이동하여 API 키를 생성하세요
  2. 키 유형 선택 — 읽기 전용 액세스에는 공개 키, 전체 읽기/쓰기 액세스에는 비공개 키를 사용하세요
  3. 첫 요청 보내기 — 콘테스트 목록을 조회해 보세요:
bash
curl -X GET https://blitzrocket.com/api/v1/contests \
  -H "x-api-key: your_api_key_here"

응답 형식

모든 API 응답은 일관된 형식을 따릅니다:

성공 응답:

json
{
  "success": true,
  "data": { ... }
}

오류 응답:

json
{
  "success": false,
  "error": "무엇이 잘못되었는지에 대한 설명"
}

다음 단계

  • 인증 — API 키 유형 및 인증 방법 알아보기
  • 요청 제한 — 요청 제한 이해하기
  • API 참조 — 사용 가능한 모든 엔드포인트 탐색하기