ตามนโยบายการดำเนินงานของคุณ เรามีฟีเจอร์ในการตั้งค่าบัญชีให้ถูกระงับบนเซิร์ฟเวอร์ 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: Hive Console > Authentication > Suspend Use > Register Type) |
| start_date | String | O | วันที่เริ่มระงับ |
| end_date | String | O | วันที่สิ้นสุดการระงับ |
การตอบสนอง
| พารามิเตอร์ | ประเภท | คำอธิบาย |
| result_code | จำนวนเต็ม | รหัสผลลัพธ์ - 0: สำเร็จ
- 4000: พารามิเตอร์ไม่ถูกต้อง
- หากรูปแบบของวันที่เริ่มต้นและวันที่สิ้นสุดไม่ถูกต้อง
- หากวันที่เริ่มต้นอยู่หลังวันที่สิ้นสุด
- หากเวลาปัจจุบันอยู่หลังวันที่สิ้นสุด
- 4002: คีย์การรับรองไม่ตรงกัน
- 4011: ประเภทที่ไม่ได้ลงทะเบียน
- 6000: appid ไม่ถูกต้อง
|
| result_msg | สตริง | ข้อความผลลัพธ์เกี่ยวกับสาเหตุของการระงับ |
ตัวอย่างคำขอ
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"}'
ตัวอย่างการตอบกลับ
{
"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 | PlayerID |
| hive_certification_key | String | O | รหัสการรับรอง (ออกใน App Center) |
การตอบกลับ
| ฟิลด์ | ประเภท | คำอธิบาย |
| result_code | จำนวนเต็ม | - 0: สำเร็จ
- 2002: ผู้ใช้ไม่ได้ถูกระงับ
- 4000: พารามิเตอร์ไม่ถูกต้อง
- 4002: คีย์การรับรองไม่ตรงกัน
- 6000: appid ไม่ถูกต้อง
|
| result_msg | สตริง | ข้อความผลลัพธ์ |
ตัวอย่างคำขอ
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"
}