เอกสาร

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

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

13.15

การเปลี่ยนแผงของทิกเก็ต

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

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

เนื้อหาคำขอ

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

รูปแบบของทิกเก็ตต้องตรงกัน ทิกเก็ตแบบช่องย้ายไปได้เฉพาะแผงที่ใช้ช่อง ส่วนทิกเก็ตแบบเธรดย้ายไปได้เฉพาะแผงที่ใช้เธรด เนื่องจากการย้ายทำให้ชื่อช่องเปลี่ยน Discord จึงอนุญาตราวสองครั้งต่อ 10 นาที ปลายทางนี้ใช้ขีดจำกัดเดียวกัน และจะคืนค่า 429 พร้อม retry_after เมื่อเกินขีดจำกัด

ตัวอย่างคำขอ
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel
ตัวอย่างการตอบกลับ
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}