Документація

Опануй 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
}