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

Научи 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
}