메인 콘텐츠로 건너뛰기

​
Base URL

환경URL상태
Devhttps://wave-api.playwave.dev/v1사용 가능
QAhttps://wave-api-qa.playwave.dev/v1준비 중
Livehttps://wave-api.playwave.io/v1준비 중

​
인증

모든 요청에 X-Api-Key 헤더가 필요합니다.
​
X-Api-Key
string
필수
게임별 API Key. 서버에서 를 게임 설정과 매칭하여 인증합니다.
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개입니다.
MethodPath설명
POST/v1/game/session/verify 검증 + 게임 세션 생성
PATCH/v1/game/session/heartbeat게임 세션 하트비트 (2분 간격)
DELETE/v1/game/session/end게임 세션 종료

​
공통 에러 코드

코드HTTP설명
BAD_REQUEST400요청 본문 검증 실패
INVALID_API_KEY401API Key 무효
RATE_LIMITED429요청 빈도 제한 초과
INTERNAL_ERROR500서버 내부 오류