การเริ่มต้นการจัดอันดับของผู้ใช้ที่ถูกระงับ
API การส่งข้อมูลผู้ใช้ที่ถูกระงับให้ข้อมูลฟังก์ชันในการส่งข้อมูลของผู้ใช้ที่ถูกระงับไปยังเซิร์ฟเวอร์เกมโดยอัตโนมัติเมื่อทำการลงทะเบียนหรือเปลี่ยนแปลงข้อมูล ผ่าน API นี้ คุณสามารถรับข้อมูลผู้ใช้ที่ถูกระงับแบบเรียลไทม์ไปยังเซิร์ฟเวอร์เกม
- เวลาการส่งข้อมูล: เมื่อข้อมูลผู้ใช้ที่ถูกระงับถูกลงทะเบียนใหม่หรือเปลี่ยนแปลง จะถูกส่งไปยังเซิร์ฟเวอร์เกมโดยอัตโนมัติ เมื่อการระงับถูกยกเลิก ข้อมูลจะไม่ถูกส่งผ่าน API
- หน่วยการส่งข้อมูล: ข้อมูลผู้ใช้ที่ถูกระงับสูงสุด 100 รายการจะถูกส่งพร้อมกับคำขอหนึ่งครั้ง ตัวอย่างเช่น หากมีผู้ใช้ที่ถูกระงับ 2,000 คน จะมีการส่งคำขอ 20 ครั้งไปยังเซิร์ฟเวอร์เกม แบ่งเป็น 100 รายการต่อครั้ง。
ในการใช้ API การส่งข้อมูลผู้ใช้ที่ถูกระงับ คุณต้องเตรียมเซิร์ฟเวอร์เกมเพื่อรับคำขอ คุณสามารถตั้งค่าการลงทะเบียนเซิร์ฟเวอร์เกมผ่านเส้นทางต่อไปนี้ในคอนโซล Hive
- เส้นทาง: Hive console > การตรวจสอบสิทธิ์ > การระงับ > ลงทะเบียนเซิร์ฟเวอร์เกม
พื้นฐาน¶
| คำอธิบาย | |
|---|---|
| Request URL | URL ของเซิร์ฟเวอร์เกมของโปรเจกต์ที่ลงทะเบียนใน Hive console เซิร์ฟเวอร์เกม: [Hive console > Authentication > Suspension > Register game server] |
| HTTP Method | POST |
| Content-type | application/json |
| Data Format | JSON |
| Authorization | Bearer Game server authentication key |
Note
- โทเค็น Bearer ตรงกับ [การรับรองความถูกต้องของ Hive console > การระงับ > ลงทะเบียนเซิร์ฟเวอร์เกม > รายละเอียดโครงการ > คีย์การรับรองความถูกต้องของเซิร์ฟเวอร์เกม].
- การตรวจสอบคีย์การรับรองความถูกต้องของเซิร์ฟเวอร์เกมต้องได้รับการพัฒนาเพื่อให้สามารถตรวจสอบได้บนเซิร์ฟเวอร์เกมที่ร้องขอ.
คำขอ¶
| ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
| game_index | จำนวนเต็ม | ใช่ | ดัชนีเกม |
| server_url | สตริง | ใช่ | URL ของเซิร์ฟเวอร์เกม |
| data | รายการ | ใช่ | รายชื่อผู้ใช้ที่ถูกระงับ |
| data.player_id | จำนวนเต็ม | ใช่ | ID ผู้เล่น |
| data.status | สตริง | ใช่ | สถานะการระงับ P: การระงับถาวร B: ผู้ใช้ที่มีระยะเวลาการระงับ |
| data.start_date | สตริง | ใช่ | วันที่เริ่มการระงับ |
| data.end_date | สตริง | ใช่ | วันที่สิ้นสุดการระงับ |
การตอบกลับ¶
| ชื่อ | ประเภท | คำอธิบาย | หมายเหตุ |
|---|---|---|---|
| result_code | จำนวนเต็ม | รหัสผลลัพธ์ | * 0: ปกติ * รหัสอื่น ๆ ทั้งหมดเป็นข้อผิดพลาด (รหัสที่ตอบกลับโดยเซิร์ฟเวอร์เกม) |
ตัวอย่างคำขอ¶
curl -X POST {URL of the game server of the project registered to the Hive console game server}
-H 'Content-Type: application/json'
-H 'Authorization: Bearer {Game server authentication key issued when registering the Hive console game server}'
-d '{"game_index": 539, "server_url": "{URL of the game server of the project registered to the Hive console game server}", "data": [{"player_id": 1, "status": "B", "start_date": "2024-07-10 20:56:59", "end_date": "2024-07-13 20:56:59"}, {"player_id": 2, "status": "B", "start_date": "2024-07-10 20:56:59", "end_date": "2024-07-20 20:56:59"}, {"player_id": 3, "status": "P", "start_date": "2024-07-10 20:56:59", "end_date": "9999-12-31 00:00:00"}]}'
ตัวอย่าง JSON การร้องขอ¶
{
"game_index": 539,
"server_url": "{URL of the game server of the project registered in the Hive console game server}",
"data": [
{
"player_id": 1,
"status": "B",
"start_date": "2024-07-10 20:56:59",
"end_date": "2024-07-13 20:56:59" }, { "player_id": 2, "status": "B", "start_date": "2024-07-10 20:56:59", "end_date": "2024-07-20 20:56:59" }, { "player_id": 3, "status": "P", "start_date": "2024-07 -10 20:56:59", "end_date": "9999-12-31 00:00:00" } . . .
(Up to 100 suspended users sent. EX) If 2,000 suspended users are registered, a total of 20 game server transmission requests will occur, 100 each.)
]
}