ข้ามไปที่เนื้อหา

ลบบัญชี

ลบ Player ID ที่เชื่อมโยงกับบัญชีผู้ใช้ที่ระบุ API ลบบัญชีทำงานผ่านการสื่อสารแบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ โดยเซิร์ฟเวอร์แอปจะเรียกเซิร์ฟเวอร์การตรวจสอบสิทธิ์ Hive โดยตรง เมื่อคำขอสำเร็จ โทเค็นของ Player ID และข้อมูล IdP (Identity Provider) ที่เชื่อมโยงทั้งหมดจะถูกลบ หลังจากลบแล้ว จะไม่สามารถเข้าสู่ระบบอัตโนมัติหรือเข้าสู่ระบบ IdP ด้วยบัญชีนั้นได้อีก

API ที่มีให้สำหรับฟีเจอร์ลบบัญชีมีดังนี้

ปลายทาง API คำอธิบาย
POST /v2/game/player/delete ลบบัญชี (ขณะเข้าสู่ระบบ)
POST /v2/game/player/delete-project ลบบัญชี (ไม่ต้องเข้าสู่ระบบ)

## ลบบัญชี (ขณะเข้าสู่ระบบ)

ใช้ API นี้เมื่อผู้ใช้ลบบัญชีของตนเองขณะเข้าสู่ระบบแอป

URL คำขอ

URL การผลิต https://auth.qpyou.cn/v2/game/player/delete
URL แซนด์บ็อกซ์ 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 รหัสแอป
did รหัสอุปกรณ์
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 access token (Project JWT) และ session token

URL คำขอ

URL การผลิต https://auth.qpyou.cn/v2/game/player/delete-project
URL แซนด์บ็อกซ์ 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 access token สำหรับการยืนยันตัวตนของเซิร์ฟเวอร์แอป
ดู การออก OAuth token		 String Y
ISCRYPT ข้อมูลถูกเข้ารหัสหรือไม่ (0 = ไม่ได้เข้ารหัส; ให้ส่ง 0 เสมอ) Integer Y

เนื้อความคำขอ

ชื่อฟิลด์ คำอธิบาย ประเภท จำเป็น
appid รหัสแอป String Y
player_id Player ID BigInteger Y
did รหัสอุปกรณ์ 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