刪除帳戶¶

刪除與特定使用者帳號關聯的玩家 ID。

帳戶刪除 API 透過伺服器到伺服器通訊進行操作，直接從應用程式伺服器呼叫 Hive 身份驗證伺服器。如果請求成功，則獲得該玩家 ID 和所有 IdP 的令牌(Identity Provider) 刪除連結資訊。刪除後，該帳號無法自動登入或IdP登入。

為「刪除帳戶」功能提供的API如下。

刪除帳戶(登入狀態): POST /v2/game/player/delete
刪除帳戶(無需登入): POST /v2/game/player/delete-project

刪除帳戶(登入狀態)¶

當用戶在登入應用程式時刪除其帳戶時使用。

Request URL¶

請求體和回應的資料格式為JSON。使用環境的URLPOST 請使用方法請求它。

環境	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` 子

回應碼{ #delete-result-code }¶

根據驗證或刪除的結果，將傳回以下程式碼。

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。