계정 삭제하기¶

특정 사용자 계정과 연결된 Player ID를 삭제합니다.

계정 삭제 API는 앱 서버에서 Hive 인증 서버로 직접 호출하는 Server-to-Server 통신 방식으로 동작합니다. 요청 성공 시 해당 Player ID의 토큰 및 모든 IdP(Identity Provider) 연동 정보가 삭제되며, 삭제 이후에는 해당 계정으로 자동 로그인 및 IdP 로그인을 진행할 수 없습니다.

'계정 삭제하기' 기능으로 제공되는 API는 아래와 같습니다.

API Endpoint	설명
`POST /v2/game/player/delete`	계정 삭제 (로그인 상태)
`POST /v2/game/player/delete-project`	계정 삭제 (로그인 불필요)

계정 삭제 (로그인 상태)¶

사용자가 앱에 로그인한 상태에서 본인의 계정을 삭제할 때 사용합니다.

Request URL¶

상용 URL	https://auth.qpyou.cn/v2/game/player/delete
Sandbox URL	https://sandbox-auth.qpyou.cn/v2/game/player/delete
HTTP Method	POST
Content-Type	application/json
Data Format	JSON

Request header¶

필드명	설명	타입	필수 여부
Authorization	앱 클라이언트 로그인 성공 후 반환된 사용자 토큰 (PlayerInfo.token)	String	Y
X-Access-Token	앱 클라이언트 로그인 후 발급받은 User Token 플레이어 본인 인증을 위한 OAuth 2.0 Access Token	String	Y
ISCRYPT	데이터 암호화 여부 (0 = 암호화 안 함) (무조건 0으로 전달)	Integer	Y

Request body¶

필드명	설명	타입	필수 여부
appid	App ID	String	Y
did	Device ID	Integer	Y
player_id	Player ID	BigInteger	Y

Response body¶

필드명	설명	타입
result_code	응답 코드 자세히	Integer
result_msg	결과 메시지	String
token_validation	JWT 검증 결과 (JWT 검증 에러)	Object
token_validation.result_code	JWT 검증 결과 코드	Integer
token_validation.result_msg	JWT 검증 결과 메시지	String

응답 코드¶

코드값	설명
0	성공
2499	JWT 검증 실패 (token_validation 참고)
5000	서버 내부 오류
7000	유효하지 않은 토큰
7001	header에 토큰값 없음

Request example¶

{
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "did": 225697886,
    "player_id": 10000000445
}

Response example¶

성공¶

{
    "result_code": 0,
    "result_msg": "SUCCESS",
    "token_validation": {
        "result_code": 0,
        "result_msg": "success"
    }
}

JWT 검증 실패¶

{
    "result_code": 2499,
    "result_msg": "JWT validation failed. See token_validation for details.",
    "token_validation": {
        "result_code": 2408,
        "result_msg": "The access token is expired. Please refresh your token."
    }
}

계정 삭제 (로그인 불필요)¶

사용자가 로그인하지 않은 상태에서 계정을 삭제할 때 사용합니다. OAuth 2.0 Access Token(Project JWT)과 세션 토큰으로 인증합니다.