계정 삭제하기¶

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

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

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	String	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 참고)
7000	헤더 토큰 에러

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."
    }
}

Note

JWT 검증 실패 시, token_validation 필드를 통해 상세한 에러 정보를 확인할 수 있습니다. 자세한 내용은 JWT 검증 에러 코드를 참고하세요.