เอกสาร

เรียนรู้ TicketsX ได้เร็วขึ้น

คู่มือการตั้งค่า รายการคำสั่งทั้งหมด ฟีเจอร์ Premium และ REST API รวมอยู่ที่เดียว

13.2

รายการทิกเก็ต

GET/<guild_id>/api/tickets

ดึงรายการทิกเก็ตที่เปิดอยู่ของเซิร์ฟเวอร์ รองรับตัวกรองเสริมเพื่อจำกัดผลลัพธ์ตามสถานะการรับดูแล ตามผู้ใช้ หรือตามคนที่เปิดทิกเก็ต

ชื่อ	ชนิด	จำเป็น	คำอธิบาย
filter	string	ไม่บังคับ	กรองทิกเก็ตตามสถานะ ค่าที่รับได้คือ `claimed` และ `mine`
user_id	string	ไม่บังคับ	กรองทิกเก็ตที่ผู้ใช้คนนี้ร่วมสนทนาอยู่
creator_id	string	ไม่บังคับ	กรองทิกเก็ตที่รหัสผู้ใช้นี้เป็นคนสร้าง
limit	number	ไม่บังคับ	จำนวนผลลัพธ์ต่อหน้า 1-100 (ค่าเริ่มต้น 50)
offset	number	ไม่บังคับ	จำนวนผลลัพธ์ที่ข้ามไปเพื่อแบ่งหน้า (ค่าเริ่มต้น 0)

การตอบกลับมีอ็อบเจ็กต์ pagination ได้แก่ { total, limit, offset, returned } และจะคืนเฉพาะทิกเก็ตที่เปิดอยู่เท่านั้น

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

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/tickets?filter=claimed&creator_id=123456789"