13
เอกสารอ้างอิง API
REST API ของ TicketsX ให้คุณเชื่อมเครื่องมือภายนอกเข้ากับระบบทิกเก็ตของเซิร์ฟเวอร์คุณ สร้าง ปิด และดูแลทิกเก็ตด้วยโค้ดโดยไม่ต้องผ่านหน้าจอ Discord ค้นในคลังบันทึกสนทนาทั้งหมด และดึงเนื้อความฉบับเต็มหรือโค้ด HTML ของทิกเก็ตที่ปิดแล้วใบไหนก็ได้
REST API เป็นความสามารถของ Premium โทเค็น API สร้างและใช้ได้เฉพาะช่วงที่เซิร์ฟเวอร์ยังมี Premium ที่ใช้งานอยู่ (ดูหน้าราคา) คำขอจากเซิร์ฟเวอร์ที่ไม่มี Premium จะถูกปฏิเสธด้วย 402 พร้อมฟิลด์ premium_required: true หาก Premium หมดอายุ โทเค็นเดิมจะยังถูกเก็บไว้แต่หยุดทำงานจนกว่าคุณจะเปิดใช้อีกครั้ง ระหว่างนั้นคุณยังดูรายการ ปิดใช้ และเพิกถอนโทเค็นจากแดชบอร์ดได้
https://api.ticketsx.xyzทุกคำขอต้องมีโทเค็น API ส่งมาเป็นโทเค็น Bearer ในส่วนหัว Authorization โทเค็นใช้ได้กับเซิร์ฟเวอร์เดียว และจำกัดสิทธิ์แยกตามการกระทำได้
Authorization: Bearer <API_TOKEN>ในทุกเส้นทางปลายทางด้านล่าง ให้แทน <guild_id> ด้วยรหัสเซิร์ฟเวอร์ Discord ของคุณ และแทน <ticket_id> ด้วยรหัสของทิกเก็ตที่ต้องการ
เนื้อหาของคำขอ POST ทุกอันต้องมี Content-Type: application/json การตอบกลับกลุ่ม 4xx จะมีฟิลด์ JSON ชื่อ error มาด้วย 401 หมายถึงโทเค็นไม่ถูกต้อง หมดอายุ หรือถูกเพิกถอน 402 หมายถึงเซิร์ฟเวอร์ไม่มี Premium (การตอบกลับจะมี premium_required: true มาด้วย) 403 หมายถึงโทเค็นถูกปิดใช้หรือไม่มีสิทธิ์ที่จำเป็น ส่วน 429 หมายถึงชนขีดจำกัดจำนวนคำขอ (ดูส่วนขีดจำกัดและความปลอดภัย) และจะมีค่า retry_after เป็นวินาทีมาด้วย