인증 | Blitz Rocket

인증

모든 Blitz Rocket API v1 엔드포인트는 API 키를 통한 인증이 필요합니다. API 키는 팀 단위로 범위가 지정되며 팀 설정 페이지에서 관리할 수 있습니다.

공개 키는 읽기 전용 접근 권한을 제공하며 클라이언트 측 코드에서 안전하게 사용할 수 있습니다. 다음에 접근할 수 있습니다:

GET /api/v1/contests — 콘테스트 목록 조회
GET /api/v1/contests/:contestId — 콘테스트 상세 조회
GET /api/v1/contests/:contestId/leaderboard — 리더보드 조회
GET /api/v1/contests/:contestId/entries — 참가 내역 목록 조회
GET /api/v1/contests/:contestId/analytics — 분석 데이터 조회
GET /api/v1/entries/:entryId — 참가 내역 상세 조회
GET /api/v1/entries/:entryId/bonus-actions — 보너스 액션 조회
POST /api/v1/entries/:entryId/bonus-actions/:bonusActionId/complete — 보너스 액션 완료 처리

비공개 키는 모든 엔드포인트에 대해 전체 읽기/쓰기 접근 권한을 제공합니다. 비공개 키는 비밀로 유지하고 서버 측 코드에서만 사용하세요. 공개 키 엔드포인트 외에 다음에 접근할 수 있습니다:

x-api-key 요청 헤더에 API 키를 전달하세요. 쿼리 파라미터로 API 키를 보내지 마세요 — 로그, 브라우저 기록, 리퍼러 헤더를 통해 노출될 수 있습니다.

bash

curl -X GET https://blitzrocket.com/api/v1/contests \
  -H "x-api-key: vk_live_abc123def456"

API 키가 없거나 유효하지 않은 경우 401 Unauthorized 응답을 받습니다:

json

{
  "success": false,
  "error": "Missing or invalid API key"
}

공개 키를 비공개 전용 엔드포인트에 사용하면 403 Forbidden 응답을 받습니다:

json

{
  "success": false,
  "error": "This endpoint requires a private API key"
}