跳轉至

帳號刪除

刪除與特定使用者帳戶連結的 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 驗證錯誤代碼。