ถูกใจ

'ถูกใจ' สามารถเพิ่มหรือลบออกจากแต่ละข้อความในช่องทางได้

เมื่อคุณเรียก API เพื่อเพิ่มหรือลบ 'ไลค์' ข้อความเหตุการณ์ที่เกี่ยวข้องกับไลค์จะถูกส่งไปยังผู้เข้าร่วมทั้งหมดในช่องทาง

เพิ่มไลค์ API¶

เพิ่ม 'ไลค์' ให้กับข้อความเฉพาะ

คุณไม่สามารถเพิ่มการชอบให้กับข้อความที่คุณได้ชอบไปแล้ว
คุณไม่สามารถเพิ่มการชอบให้กับข้อความประกาศ

URL การร้องขอ¶

เซิร์ฟเวอร์	URL
LIVE	`https://plugin-chat.withhive.com/plugin/api/like/v1/games/{gameIndex}/channels/{channelId}/messages/{messageId}`
SANDBOX	`https://sandbox-plugin-chat.withhive.com/plugin/api/like/v1/games/{gameIndex}/channels/{channelId}/messages/{messageId}`
HTTP METHOD	`POST`

พารามิเตอร์เส้นทาง¶

ฟิลด์	คำอธิบาย	ประเภท	จำเป็น
gameIndex	ดัชนีเกม Hive	จำนวนเต็ม	ใช่
channelId	รหัสช่อง	สตริง	ใช่
messageId	รหัสข้อความ	สตริง	ใช่

พารามิเตอร์หัวเรื่อง¶

ฟิลด์	คำอธิบาย	ประเภท	จำเป็น
Authorization	โทเค็นการตรวจสอบสิทธิ์สำหรับการเรียก API (`Bearer`)	สตริง	ใช่
Content-Type	ประเภทของข้อมูลคำขอ (`application/json`)	สตริง	ใช่

เนื้อหาคำขอ¶

ฟิลด์	คำอธิบาย	ประเภท	จำเป็น

เนื้อหาการตอบกลับ¶

ฟิลด์	คำอธิบาย	ประเภท
รหัส	รหัสการตอบกลับ	จำนวนเต็ม
ข้อความ	ข้อความผลลัพธ์	สตริง

ตัวอย่างคำขอ¶

curl --location 'https://plugin-chat.withhive.com/plugin/api/like/v1/games/1/channels/open:12345/messages/0196f733-4f33-7a63-a657-5b0e5e792472' \
--header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ysjs' \
--data '{"playerId":1}'

ตัวอย่างการตอบกลับ¶

{
    "code": 0,
    "message": "Success."
}

ลบเหมือน¶

ลบการถูกใจจากข้อความ

คุณสามารถลบไลค์ที่คุณได้เพิ่มเองเท่านั้น

URL การร้องขอ¶

เซิร์ฟเวอร์	URL
LIVE	`https://plugin-chat.withhive.com/plugin/api/like/v1/games/{gameIndex}/channels/{channelId}/messages/{messageId}/players/{playerId}`
SANDBOX	`https://sandbox-plugin-chat.withhive.com/plugin/api/like/v1/games/{gameIndex}/channels/{channelId}/messages/{messageId}/players/{playerId}`
HTTP METHOD	`DELETE`

พารามิเตอร์เส้นทาง¶

ฟิลด์	คำอธิบาย	ประเภท	จำเป็น
gameIndex	ดัชนีเกม Hive	จำนวนเต็ม	ใช่
channelId	รหัสช่อง	สตริง	ใช่
messageId	รหัสข้อความ	สตริง	ใช่
playerId	รหัสผู้เล่นของผู้ใช้ที่ลบไลค์	ยาว	ใช่

พารามิเตอร์หัวเรื่อง¶

ฟิลด์	คำอธิบาย	ประเภท	จำเป็น
Authorization	โทเค็นการตรวจสอบสิทธิ์สำหรับการเรียก API (`Bearer`)	สตริง	ใช่

เนื้อหาการตอบกลับ¶

ฟิลด์	คำอธิบาย	ประเภท
รหัส	รหัสการตอบกลับ	จำนวนเต็ม
ข้อความ	ข้อความผลลัพธ์	สตริง

ตัวอย่างคำขอ¶

curl --location --request DELETE 'https://plugin-chat.withhive.com/plugin/api/like/v1/games/1/channels/open:12345/messages/0196f733-4f33-7a63-a657-5b0e5e792472/players/1' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ysjs'

ตัวอย่างการตอบกลับ¶

{
    "code": 0,
    "message": "Success."
}

รหัสการตอบกลับ¶

นอกเหนือจากรหัสการตอบสนองทั่วไป รหัสการตอบสนองต่อไปนี้เป็นรหัสที่เฉพาะเจาะจงสำหรับฟีเจอร์การถูกใจ

รหัสสถานะ HTTP	รหัส	ข้อความ	คำอธิบาย
400	10000	ไม่พบหรือถูกลบ Like.	ไม่พบข้อมูล Like
400	10001	ไม่พบหรือถูกลบข้อความ.	ข้อความสำหรับข้อมูล Like ไม่พบ
400	10002	ข้อความมีข้อมูล Like อยู่แล้ว.	ข้อมูล Like มีอยู่แล้ว

การตอบสนอง API รวมถึงข้อมูลที่ชอบ¶

ส่วนนี้อธิบายข้อมูลที่คล้ายกันซึ่งรวมอยู่ในคำตอบของ API ประวัติข้อความช่อง

ร่างตอบกลับ > ข้อมูล > เนื้อหา > pluginData¶

หากข้อความช่องมีข้อมูลการถูกใจ ฟิลด์ like จะรวมอยู่ใน data > content > pluginData ของ ร่างการตอบกลับ API ประวัติข้อความช่อง

ฟิลด์	คำอธิบาย	ประเภท
like	ข้อมูลการถูกใจ	วัตถุ

เนื้อหาของการตอบกลับ > ข้อมูล > เนื้อหา > pluginData > ชอบ¶

ฟิลด์	คำอธิบาย	ประเภท
playerIds	รหัสผู้เล่นของผู้ใช้ที่ชอบข้อความ	อาร์เรย์ยาว

ตัวอย่างการตอบกลับ¶

{
  // ...omitted
        "content": [
            {
                "gameIndex": 1374,
                "from": 1,
                "messageId": "ggJ5Csh15J-mI3i5",
                "extraData": "",
                "pluginData": {
                    "like": {
                        "playerIds": [
                            1
                        ]
                    }
                },
                "to": "public:10",
                "message": "aaa",
                "langCode": "ko",
                "timestamp": "2025-07-17T00:56:17.156Z",
                "timestampMillis": 1752713777156
            }
        ]
  // ...omitted
}