Tài liệu

Nắm TicketsX nhanh hơn

Hướng dẫn thiết lập, toàn bộ danh sách lệnh, tính năng Premium và REST API, gom về một chỗ.

13.15

Đổi bảng của ticket

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

Chuyển một ticket sang bảng đơn khác. Đây là cách làm tương đương lệnh /switchpanel qua API. Ticket được đặt tên theo cách đặt tên của bảng mới, với ticket dạng kênh thì chuyển sang danh mục của bảng đó, còn các đội hỗ trợ của bảng mới thì được quyền vào. Cần quyền `switch_panel` (mặc định tắt).

Thân yêu cầu

TênKiểuBắt buộcMô tả
panel_idnumber
bắt buộc
Mã của bảng đơn mà ticket sẽ chuyển sang (xem Liệt kê bảng).
keep_permissionsboolean
tùy chọn
Giữ nguyên các quyền theo vai trò hiện có trên kênh bên cạnh các đội của bảng mới (mặc định true). Đặt false để chỉ còn các đội hỗ trợ của bảng mới vào được.

Kiểu ticket phải khớp nhau: ticket dạng kênh chỉ chuyển sang bảng dùng kênh, còn ticket dạng luồng chỉ chuyển sang bảng dùng luồng. Vì việc chuyển làm đổi tên kênh nên Discord chỉ cho khoảng hai lần mỗi 10 phút; điểm cuối này giữ đúng giới hạn đó và trả về 429 kèm retry_after khi bạn vượt quá.

Ví dụ về yêu cầu
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
Ví dụ về phản hồi
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}