การเริ่มต้นการจัดอันดับของผู้ใช้ที่ถูกระงับ
การลงทะเบียนเซิร์ฟเวอร์เกมสำหรับการระงับการใช้งาน¶
API การลงทะเบียนเซิร์ฟเวอร์เกมสำหรับการระงับการใช้งานมีฟังก์ชันส่งข้อมูลของผู้ใช้ที่ถูกระงับการใช้งานไปยังเซิร์ฟเวอร์เกมโดยอัตโนมัติเมื่อมีการลงทะเบียนหรือเปลี่ยนแปลงข้อมูลดังกล่าว คุณสามารถรับข้อมูลผู้ใช้ที่ถูกระงับการใช้งานแบบเรียลไทม์ผ่าน API นี้บนเซิร์ฟเวอร์เกมได้
- เวลาการส่งข้อมูล: เมื่อข้อมูลผู้ใช้ที่ถูกระงับถูกลงทะเบียนใหม่หรือเปลี่ยนแปลง จะถูกส่งไปยังเซิร์ฟเวอร์เกมโดยอัตโนมัติ เมื่อการระงับถูกยกเลิก ข้อมูลจะไม่ถูกส่งผ่าน API
- หน่วยการส่งข้อมูล: ข้อมูลผู้ใช้ที่ถูกระงับสูงสุด 100 รายการจะถูกส่งพร้อมกับคำขอหนึ่งครั้ง ตัวอย่างเช่น หากมีผู้ใช้ที่ถูกระงับ 2,000 คน จะมีการส่งคำขอ 20 ครั้งไปยังเซิร์ฟเวอร์เกม แบ่งเป็น 100 รายการต่อครั้ง。
หากต้องการใช้ API การลงทะเบียนเซิร์ฟเวอร์เกมสำหรับการระงับการใช้งาน คุณต้องเตรียมเซิร์ฟเวอร์เกมให้สามารถรับคำขอ (Request) ได้ การลงทะเบียนเซิร์ฟเวอร์เกมสามารถตั้งค่าได้ผ่านเส้นทางด้านล่างใน Hive Console
- เส้นทาง: Hive Console > การยืนยันตัวตน > การระงับการใช้งาน > การลงทะเบียนเซิร์ฟเวอร์เกม
พื้นฐาน¶
| คำอธิบาย | |
|---|---|
| Request URL | URL ของเซิร์ฟเวอร์เกมของโปรเจ็กต์ที่ลงทะเบียนไว้ในเซิร์ฟเวอร์เกมของ Hive Console : [Hive Console > การยืนยันตัวตน > การระงับการใช้งาน > การลงทะเบียนเซิร์ฟเวอร์เกม] |
| 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 | List | O | รายชื่อผู้ใช้ที่ถูกระงับการใช้งาน |
| data.player_id | จำนวนเต็ม | ใช่ | ID ผู้เล่น |
| data.status | String | O | สถานะการระงับการใช้งาน 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.)
]
}