API การแจ้งเตือนกิจกรรมชุมชน

Community Activity Notification API รองรับให้บริษัทเกมสามารถรับ PlayerID ของผู้เขียนโพสต์เมื่อผู้ใช้เขียนโพสต์บนบอร์ดเฉพาะในคอมมูนิตี้

ภาพรวม¶

เมื่อบริษัทเกมลงทะเบียน API endpoint สำหรับรับ PlayerID ใน Hive Console แล้ว Hive Community จะส่ง PlayerID ของผู้เขียนโพสต์หรือคอมเมนต์ไปยัง endpoint นี้ สามารถใช้เพื่อเชื่อมต่อ Hive Community กับเซิร์ฟเวอร์เกมเพื่อเชื่อมโยงกิจกรรมคอมมูนิตี้ของผู้ใช้กับระบบรางวัลในเกมและอื่นๆ

วิธีใช้งานมีดังนี้:

1. บริษัทเกม: ลงทะเบียน API endpoint (callback URL) ใน Hive Console Community & Web Shop > Community UI > Game Integration > Notification Settings

   • รูปแบบ callback URL สามารถกำหนดได้อย่างอิสระโดยบริษัทเกม
   • สเปก API อื่นๆ ให้ปฏิบัติตามหัวข้อ API Request Configuration และ API Response Configuration ด้านล่าง

   

2. เซิร์ฟเวอร์ Hive Community: เมื่อผู้ใช้เขียนโพสต์บนบอร์ดเฉพาะหรือแสดงความคิดเห็น PlayerID ของผู้เขียนจะถูกส่งไปยังเซิร์ฟเวอร์เกมในรูปแบบ callback (โดยมี player_id ใน Request body)

3. บริษัทเกม: ใช้ PlayerID นี้ได้อย่างอิสระสำหรับอีเวนต์ในเกม ลอจิกรางวัลเควส และอื่นๆ

ข้อกำหนดเบื้องต้น¶

• การสมัครและเริ่มต้นใช้งาน Hive Platform

การกำหนดค่า API Request (เซิร์ฟเวอร์ Hive → เซิร์ฟเวอร์เกม)¶

นี่คือข้อมูล POST request ที่ส่งจากเซิร์ฟเวอร์ Hive ไปยังเซิร์ฟเวอร์เกม

Request header¶

Request body¶

Request body sample¶

{
    "player_id" : 20000010000,
    "lang" : "ko",
    "board_idx" : 12345,
    "board_name" : "Event",
    "write_type" : "board",
    "reg_date" : "2025-08-14 10:12:18"
}

การกำหนดค่า API Response (เซิร์ฟเวอร์เกม → เซิร์ฟเวอร์ Hive)¶

นี่คือข้อมูล response ที่ส่งจากเซิร์ฟเวอร์เกมไปยังเซิร์ฟเวอร์ Hive

Response body¶

• Data type: JSON
• Parameters

Response Code¶

• ต้องส่งค่าสำเร็จเป็น 100 เสมอ

Response Sample¶

{
    "result_code": 100,
    "result_msg": "success"
}