ตรวจสอบผู้ใช้ที่ถูกระงับการใช้งานเกม¶

API นี้ใช้ตรวจสอบผู้ใช้ที่ถูกบล็อกไม่ให้เข้าแอปเมื่อพยายามเข้าสู่ระบบผ่านเว็บจากชุมชนหรือเว็บเพจ เป็นต้น

URL คำขอ¶

URL ใช้งานจริง	https://auth.qpyou.cn/v2/game/block/get
URL Sandbox	https://sandbox-auth.qpyou.cn/v2/game/block/get
วิธี HTTP	POST
Content-Type	application/json
รูปแบบข้อมูล	JSON

ส่วนหัวคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
X-Access-Token	OAuth 2.0 Access Token สำหรับการรับรองความถูกต้องของเซิร์ฟเวอร์แอป (ดู ออก OAuth Token)	String	Y
ISCRYPT	ข้อมูลถูกเข้ารหัสหรือไม่ (0 = ไม่เข้ารหัส) (ต้องส่ง 0 เสมอ)	Integer	Y

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
appid	App ID	String	Y
player_id	Player ID	Integer	Y
language	Language value. If omitted, English is used by default. ko (Korean) en (English) ja (Japanese) zh-hans (Simplified Chinese) zh-hant (Traditional Chinese) de (German) fr (French) ru (Russian) es (Spanish) pt (Portuguese) id (Indonesian) th (Thai) vi (Vietnamese) it (Italian) tr (Turkish) ar (Arabic) tl (Filipino)	String	N

ตัวอย่างคำขอ¶

{"appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal","player_id":20000020208,"language":"ko"}

เนื้อหาการตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
result_code	รหัสตอบกลับ รายละเอียด	Integer
result_msg	ข้อความผลลัพธ์	String
token_validation	ผลการตรวจสอบ JWT (ข้อผิดพลาดการตรวจสอบ JWT)	Object
token_validation.result_code	รหัสผลการตรวจสอบ JWT	Integer
token_validation.result_msg	ข้อความผลการตรวจสอบ JWT	String
data	ข้อมูลผลลัพธ์	Object
data.is_blocked	Whether access is suspended `true`: suspended user `false`: normal user	Boolean
data.status	Suspension status `N`: normal user `P`: permanently suspended user `B`: user suspended for a specified period	String
data.start_date	Suspension start date	String
data.end_date	Suspension end date	String
data.remaining_date	Remaining suspension period (returned in the requested `language`; default: English)	String
data.reason	Suspension reason (returned in the requested `language`; default: English)	String

รหัสตอบกลับ¶

Code value	คำอธิบาย
0	สำเร็จ
2499	การตรวจสอบ JWT ล้มเหลว (ดู token_validation)
4000	พารามิเตอร์ไม่ถูกต้อง
6000	appid ไม่ถูกต้อง

ตัวอย่างการตอบกลับ¶

สำเร็จ (normal user)¶

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":false,"status":"N","start_date":null,"end_date":null,"remaining_date":null,"reason":null}}

สำเร็จ (user suspended for a specified period)¶

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":true,"status":"B","start_date":"2024-05-15 10:00:00","end_date":"2024-06-30 23:59:59","remaining_date":"27d 5hr 8min","reason":"Temporary Restriction (Retrieve game money)"}}

สำเร็จ (permanently suspended user)¶

{"result_code":0,"result_msg":"SUCCESS","token_validation":{"result_code":0,"result_msg":"success"},"data":{"is_blocked":true,"status":"P","start_date":"2024-05-15 10:00:00","end_date":"9999-12-31 00:00:00","remaining_date":"Permanent","reason":"Temporary Restriction (Retrieve game money)"}}

JWT validation failure¶

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

ล้มเหลว¶

{"result_code":4000,"result_msg":"Request has invalid format.","token_validation":{"result_code":0,"result_msg":"success"},"data":"player_id"}

Note

เมื่อการตรวจสอบ JWT ล้มเหลว คุณสามารถดูข้อมูลข้อผิดพลาดโดยละเอียดได้ในฟิลด์ token_validation โปรดดู รหัสข้อผิดพลาดการตรวจสอบ JWT สำหรับรายละเอียด