跳转至

账号删除

删除与特定用户帐户关联的 Player ID。 帐户删除 API 通过服务器到服务器通信运行，由应用程序服务器直接调用 Hive 身份验证服务器。请求成功后，Player ID 的令牌以及所有关联的 IdP（身份提供商）信息都会被删除。删除后，无法再使用该帐户进行自动登录或 IdP 登录。

帐户删除功能提供以下 API。

API 端点 说明
POST /v2/game/player/delete 删除帐户（已登录）
POST /v2/game/player/delete-project 删除帐户（无需登录）

## 删除帐户（已登录）

用户登录应用程序后删除自己的帐户时使用此 API。

请求网址

生产网址 https://auth.qpyou.cn/v2/game/player/delete
沙箱网址 https://sandbox-auth.qpyou.cn/v2/game/player/delete
HTTP 方法 POST
Content-Type application/json
数据格式 JSON

### 请求头
字段名称 描述
--- ---
Authorization 游戏客户端成功登录后返回的用户令牌（PlayerInfo.token）
X-Access-Token 游戏客户端登录后颁发的用户令牌
OAuth 2.0 用于验证玩家身份的访问令牌
ISCRYPT 数据是否加密（0 = 未加密；始终传递 0）

## 请求正文
字段名称 描述
--- ---
appid 应用程序 ID
did 设备 ID
player_id Player ID

### 响应体
字段名称 描述
--- ---
result_code 响应代码 详情
result_msg 结果留言
token_validation JWT 验证结果 (JWT 验证错误)
token_validation.result_code JWT验证结果码
token_validation.result_msg JWT 验证结果消息
#### 响应代码
代码值 描述
--- ---
0 成功
2499 JWT 验证失败（请参阅 token_validation）
5000 服务器内部错误
7000 无效令牌
7001 标头中没有令牌值

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


响应示例

成功

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

删除帐户（无需登录）

用户未登录时删除帐户使用此 API。使用 OAuth 2.0 访问令牌（Project JWT）和会话令牌进行身份验证。

请求网址

生产网址 https://auth.qpyou.cn/v2/game/player/delete-project
沙箱网址 https://sandbox-auth.qpyou.cn/v2/game/player/delete-project
HTTP 方法 POST
Content-Type application/json
数据格式 JSON

请求头

字段名称 描述 类型 必填
Authorization 应用程序客户端成功登录后返回的用户令牌（PlayerInfo.token） String Y
X-Access-Token 用于应用程序服务器身份验证的 OAuth 2.0 访问令牌
请参阅 签发 OAuth 令牌。		 String Y
ISCRYPT 数据是否加密（0 = 未加密；始终传递 0） Integer Y

请求正文

字段名称 描述 类型 必填
appid 应用程序 ID String Y
player_id Player ID BigInteger Y
did 设备 ID Integer Y

响应体

字段名称 描述 类型
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 标头中没有令牌值

请求示例

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

响应示例

成功

{
    "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 验证错误代码。