คู่มือ API การระงับการใช้งาน¶

ตามนโยบายการดำเนินงานของคุณ เรามีฟีเจอร์ในการตั้งค่าบัญชีให้ถูกระงับบนเซิร์ฟเวอร์ Hive โดยการลงทะเบียนล่วงหน้าประเภทการระงับในคอนโซล Hive คุณสามารถแยกแยะและลงทะเบียนผู้ใช้ที่ถูกระงับถาวรและผู้ใช้ที่มีระยะเวลาการระงับชั่วคราว นอกจากนี้ คุณยังสามารถเปลี่ยนประเภทการระงับและระยะเวลาการระงับสำหรับผู้ใช้ (แยกตาม PlayerID) ที่ได้ลงทะเบียนไว้แล้ว

พื้นฐาน¶

URL ที่ร้องขอ	ผลิตภัณฑ์: https://auth.qpyou.cn/game/block/set Sandbox: https://sandbox-auth.qpyou.cn/game/block/set
วิธีการ	POST
HTTP Header	ประเภทเนื้อหา: application/json ISCRYPT: 0
รูปแบบการตอบกลับ	JSON

คำขอ¶

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
appid	String	O	AppID
player_id	Integer	O	PlayerID
hive_certification_key	String	O	รหัสการรับรอง (ออกจาก App Center)
status	String	O	สถานะการระงับ `P`: การระงับถาวร `B`: ผู้ใช้ที่มีระยะเวลาการระงับ
block_type	Integer	O	หมายเลขประเภทการระงับการใช้งาน ต้องลงทะเบียนไว้ล่วงหน้าใน [Hive Console > การรับรองความถูกต้อง > การระงับการใช้งาน > ลงทะเบียนประเภท]
start_date	String	O	วันที่เริ่มระงับ
end_date	String	O	วันที่สิ้นสุดการระงับ
skip_blocked	Boolean	X	หากส่งคำขอด้วย `skip_blocked=true` และมีข้อมูลการบล็อกเดิมอยู่แล้ว ระบบจะไม่เปลี่ยนข้อมูลการบล็อกและส่งกลับ `result_code=0`.
did	Integer	X	เป็นตัวระบุแอปเกมที่สร้างขึ้นเมื่อมีการติดตั้งแอปเกม ใช้เพื่อระบุแอปเกมประเภทเดียวกัน เมื่อเริ่มต้น SDK หากส่งค่าที่ได้รับคืนซึ่งออกใหม่หรือมีอยู่แล้ว ระบบจะตรวจสอบประวัติการเข้าสู่ระบบของอุปกรณ์นั้น

การตอบสนอง¶

พารามิเตอร์	ประเภท	คำอธิบาย
result_code	จำนวนเต็ม	รหัสผลลัพธ์ 0: สำเร็จ 4000: พารามิเตอร์ไม่ถูกต้อง หากรูปแบบของวันที่เริ่มต้นและวันที่สิ้นสุดไม่ถูกต้อง หากวันที่เริ่มต้นอยู่หลังวันที่สิ้นสุด หากเวลาปัจจุบันอยู่หลังวันที่สิ้นสุด 4002: คีย์การรับรองไม่ตรงกัน 4011: ประเภทที่ไม่ได้ลงทะเบียน 4013: การตรวจสอบประวัติการเข้าสู่ระบบของ `did` ล้มเหลว ไม่สามารถตรวจสอบได้ในสถานะออกจากระบบ 6000: appid ไม่ถูกต้อง
result_msg	สตริง	ข้อความผลลัพธ์เกี่ยวกับสาเหตุของการระงับ

ตัวอย่างคำขอลงทะเบียนการระงับการใช้งานแบบจำกัดระยะเวลา¶

เมื่อลงทะเบียนผู้ใช้ที่ถูกระงับการใช้งานแบบจำกัดระยะเวลา ให้กำหนด status เป็น B และส่ง start_date, end_date มาพร้อมกัน

curl -X POST https://auth.qpyou.cn/game/block/set \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "status" : "B", "block_type" : 18, "start_date" : "2024-06-03 00:00:00", "end_date" : "2024-06-30 23:59:59", "skip_blocked" : true, "did" : 2000000}'

ตัวอย่างการตอบกลับสำเร็จของการลงทะเบียนการระงับการใช้งานแบบจำกัดระยะเวลา¶

หากประมวลผลคำขอสำเร็จ ระบบจะส่งกลับ result_code เป็น 0 และ result_msg เป็น SUCCESS.

{
"result_code": 0,
"result_msg": "SUCCESS"
}

ปลดผู้ใช้จากการระงับ¶

ปล่อยบัญชีเฉพาะออกจากการระงับโดยตรงบนเซิร์ฟเวอร์ Hive

พื้นฐาน¶

URL ที่ร้องขอ	การผลิต: https://auth.qpyou.cn/game/block/delete Sandbox: https://sandbox-auth.qpyou.cn/game/block/delete
วิธีการ	POST
HTTP Header	ประเภทเนื้อหา: application/json ISCRYPT: 0
รูปแบบการตอบกลับ	JSON

คำขอ¶

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
appid	String	O	AppID
player_id	Integer	O	ไอดีผู้เล่น
hive_certification_key	String	O	รหัสการรับรอง (ออกใน App Center)

การตอบกลับ¶

ฟิลด์	ประเภท	คำอธิบาย
result_code	จำนวนเต็ม	0: สำเร็จ 2002: ผู้ใช้ไม่ได้ถูกระงับ 4000: พารามิเตอร์ไม่ถูกต้อง 4002: คีย์การรับรองไม่ตรงกัน 6000: appid ไม่ถูกต้อง
result_msg	สตริง	ข้อความผลลัพธ์

ตัวอย่างคำขอยกเลิกการระงับการใช้งาน¶

เมื่อต้องการยกเลิกการระงับการใช้งานของบัญชีที่ระบุ ให้ส่ง appid, player_id, hive_certification_key มาพร้อมกันตามรูปแบบคำขอด้านล่าง

curl -X POST https://auth.qpyou.cn/game/block/delete \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"}'

ตัวอย่างการตอบกลับสำเร็จของการยกเลิกการระงับการใช้งาน¶

หากประมวลผลคำขอสำเร็จ ระบบจะส่งกลับ result_code เป็น 0 และ result_msg เป็น SUCCESS.

{
   "result_code": 0,
   "result_msg": "SUCCESS"
}