13.15
การเปลี่ยนแผงของทิกเก็ต
POST
/<guild_id>/api/tickets/<ticket_id>/switch-panelย้ายทิกเก็ตไปยังแผงเดี่ยวอีกแผงหนึ่ง นี่คือคำสั่ง /switchpanel ในรูปแบบ API ทิกเก็ตจะถูกตั้งชื่อใหม่ตามรูปแบบของแผงใหม่ ถ้าเป็นทิกเก็ตแบบช่องก็ย้ายไปหมวดหมู่ของแผงนั้น และทีมซัพพอร์ตของแผงใหม่จะได้สิทธิ์เข้าถึง ต้องมีสิทธิ์ `switch_panel` (ปิดไว้เป็นค่าเริ่มต้น)
เนื้อหาคำขอ
| ชื่อ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| panel_id | number | จำเป็น | รหัสของแผงเดี่ยวที่จะย้ายทิกเก็ตไป (ดูรายการแผง) |
| keep_permissions | boolean | ไม่บังคับ | คงสิทธิ์ของยศเดิมในช่องไว้ควบคู่กับทีมของแผงใหม่ (ค่าเริ่มต้น 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
}