Skip to content

오류 코드 ​

오류 응답은 { "ok": false, "error": { "code", "message", "details"? }, "trace_id" } 형식이에요. code로 판단하세요.

공통 ​

HTTPcode뜻
400INVALID_PARAM요청 형식이 잘못됨 (message에 어느 필드인지)
404NOT_FOUND없는 리소스·경로
405METHOD_NOT_ALLOWEDHTTP 메서드가 틀림
500INTERNAL서버 내부 오류 — trace_id와 함께 문의

인증 ​

HTTPcode뜻대응
401MISSING_SIGNATURE서명 헤더 없음X-App-Key·X-Timestamp·X-Nonce·X-Signature (웹은 Origin)
401INVALID_APP_KEY모르는 App Key키 확인
401INVALID_SIGNATURE서명 불일치Secret·서명 문자열 확인 — 테스트하기
401TIMESTAMP_SKEW기기 시각이 ±300초 넘게 차이응답 server_time으로 보정 후 재시도
401REPLAYED_REQUEST이미 쓴 Nonce요청마다 새 Nonce
401AUTH_REQUIRED유저 토큰 없음로그인 후 호출
401AUTH_TOKEN_INVALIDAccess Token 만료·잘못됨토큰 갱신 후 재시도
401REFRESH_TOKEN_EXPIRED · _INVALID · _REVOKEDRefresh Token 사용 불가다시 로그인
401REFRESH_TOKEN_REUSED이미 쓴 Refresh Token — 모든 세션 종료다시 로그인, 새 토큰 저장 확인
401INVALID_PROVIDER_TOKENGoogle·Apple·플랫폼 토큰 검증 실패토큰 만료·클라이언트 ID 등록 확인
403GAME_SUSPENDED게임이 정지 상태운영 담당자 문의
403PLAYER_BANNED제재된 유저제재 안내 화면
403PLAYER_DELETED파기된 유저새로 시작 안내
403WEB_NOT_ENABLED웹 접속이 꺼짐허용 도메인 등록 요청
403ORIGIN_NOT_ALLOWED허용 도메인이 아닌 주소게임 주소 등록 요청
403WEB_NOT_SUPPORTED웹에서 쓸 수 없는 API앱 전용 (스토어 결제·MAX 광고)

기능 ​

HTTPcode뜻대응
400PROVIDER_NOT_CONFIGURED해당 로그인·결제 연동이 설정되지 않음운영 담당자에게 연동 요청
409VERSION_CONFLICT저장 version 불일치다시 읽어 합친 뒤 저장
409ALREADY_LINKED다른 유저에 연결된 계정그 계정으로 로그인
409PROVIDER_ALREADY_LINKED같은 종류 계정이 이미 연결됨—
409PURCHASE_OWNED_BY_OTHER다른 유저가 등록한 영수증지급하지 않음
409AD_NOT_REWARDED보상 확정 전 광고 세션상태 확인 후 다시
413VALUE_TOO_LARGE저장 값 크기 초과값 나누기
422RECEIPT_INVALID위조·취소·상품 불일치 영수증지급하지 않음
422RECEIPT_REVOKED환불·취소된 결제지급하지 않음
422SCORE_OUT_OF_RANGE허용 범위 밖 점수—
422STORAGE_KEY_LIMIT키 개수 초과키 합치기
429RATE_LIMITED요청 한도 초과Retry-After초 후 재시도
429SUBMIT_TOO_FAST점수 제출 간격 제한잠시 후 제출
429AD_DAILY_CAP오늘 광고 보상 한도광고 버튼 숨김
429EVENT_QUOTA_EXCEEDED오늘 이벤트 한도 초과이벤트 줄이기
500STORE_CONFIG_INVALID스토어 연동 설정 오류운영 담당자 문의
503STORE_UNAVAILABLE · UPSTREAM_UNAVAILABLE스토어·외부 서버 장애스토어 완료 처리 없이 나중에 재시도

SDK 전용 코드 ​

code뜻
NETWORK_ERROR네트워크 끊김·타임아웃 (웹은 CORS 차단 포함)
NOT_LOGGED_IN로그인 전 호출
NOT_SUPPORTED설치·설정되지 않은 기능
CANCELED유저가 결제·로그인 취소
STORE_ERROR (Unity) · PLATFORM_ERROR (HTML5)스토어·플랫폼 SDK 오류

© WEBZEN K. All rights reserved.