API 개요

PlayWave Game Server API 인증, Base URL, 응답 형식

​

Base URL

환경	URL	상태
Dev	https://wave-api.playwave.dev/v1	사용 가능
QA	https://wave-api-qa.playwave.dev/v1	준비 중
Live	https://wave-api.playwave.io/v1	준비 중

​

인증

모든 요청에 X-Api-Key 헤더가 필요합니다.

X-Api-Key · string · 필수

게임별 API Key. 서버에서 SHA-256 해시를 게임 설정과 매칭하여 인증합니다.

API Key는 현재 PlayWave 서비스 운영 담당자에게 요청하여 발급받을 수 있습니다. 담당자에게 연락하여 게임별 키를 요청하세요.

Content-Type · string · 필수

application/json이어야 합니다.

API Key는 서버 사이드에서만 사용하세요. 클라이언트에 노출되면 즉시 콘솔에서 재발급하세요.

​

응답 형식

​

성공 응답

{
  "success": true,
  "request_id": "req_abc123",
  "data": {
    // 엔드포인트별 응답 데이터
  }
}

​

에러 응답

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API Key is invalid or inactive",
    "timestamp": "2026-03-06T12:00:00.000Z"
  }
}

​

엔드포인트 목록

게임 서버에서 호출하는 API는 3개입니다.

Method	Path	설명
POST	/v1/game/session/verify	OTT 검증 + 게임 세션 생성
PATCH	/v1/game/session/heartbeat	게임 세션 하트비트 (2분 간격)
DELETE	/v1/game/session/end	게임 세션 종료

​

공통 에러 코드

코드	HTTP	설명
BAD_REQUEST	400	요청 본문 검증 실패
INVALID_API_KEY	401	API Key 무효
RATE_LIMITED	429	요청 빈도 제한 초과
INTERNAL_ERROR	500	서버 내부 오류