删除账户¶

删除与特定用户帐户关联的玩家 ID。

帐户删除 API 通过服务器到服务器通信进行操作，直接从应用程序服务器调用 Hive 身份验证服务器。如果请求成功，则获得该玩家 ID 和所有 IdP 的令牌(Identity Provider) 删除链接信息。删除后，该帐号无法自动登录或IdP登录。

为“删除账户”功能提供的API如下。

删除账户(登录状态): POST /v2/game/player/delete
删除账户(无需登录): POST /v2/game/player/delete-project

删除账户(登录状态)¶

当用户在登录应用程序时删除其帐户时使用。

Request URL¶

请求体和响应的数据格式为JSON。使用环境的URL POST 请使用方法请求它。

环境	URL	HTTP Method	Content-Type
商业	`https://auth.qpyou.cn/v2/game/player/delete`	`POST`	`application/json`
Sandbox	`https://sandbox-auth.qpyou.cn/v2/game/player/delete`	`POST`	`application/json`

Request header¶

Authorization包含用户令牌， X-Access-Token请传递如下所述的访问令牌。 ISCRYPT必须 0它必须被传承下去。

字段名称	描述	类型	需要吗？
`Authorization`	从应用程序客户端成功登录后返回的用户令牌。 PlayerInfo.playerToken	String	Y
`X-Access-Token`	用于用户身份验证的 OAuth 2.0 访问令牌。登录成功后返回 PlayerInfo.accessToken	String	Y
`ISCRYPT`	您的数据是否加密。 `0`表示未加密，并且必须是 `0`传递给	Integer	Y

Request body¶

请提供您要删除的帐户的应用程序 ID、设备 ID 和玩家 ID。

字段名称	描述	类型	需要吗？
`appid`	App ID	String	Y
`did`	Device ID	Integer	Y
`player_id`	Player ID	BigInteger	Y

Response body¶

result_code使用来检查帐户删除的结果。如果JWT验证失败 token_validation检查详细错误。错误是什么意思？ JWT验证错误代码见。

字段名称	描述	类型	地点
`result_code`	响应码	Integer	响应体
`result_msg`	结果信息	String	响应体
`token_validation`	JWT验证结果 (JWT 验证错误)	Object	响应体
`token_validation.result_code`	JWT验证结果码	Integer	`token_validation` 子
`token_validation.result_msg`	JWT验证结果消息	String	`token_validation` 子

响应码¶

根据验证或删除的结果，将返回以下代码。

0：成功
2499: JWT 验证失败。 token_validation 另请参阅
5000: 服务器内部错误
7000: 无效令牌
7001: 请求头中没有令牌值

Request example¶

这是指定要删除的帐户的请求正文的示例。身份验证令牌和 ISCRYPT将其单独包含在请求标头中。

{
    "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 验证失败¶

这是由于 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）和用户令牌进行认证。此方式也必须在 Authorization 中传递 PlayerInfo.playerToken。