Dokumentation

Lär dig TicketsX snabbare

Guider, alla kommandon, Premium-funktioner och REST-API:et på ett ställe.

13.15

Byta panel för ett ärende

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

Flyttar ett ärende till en annan enkel panel. Det är API-motsvarigheten till kommandot /switchpanel. Ärendet får namn enligt den nya panelens namnmall, flyttas till dess kategori (för ärenden som är kanaler) och den nya panelens supportteam får tillgång. Kräver behörigheten `switch_panel` (av som standard).

Anropets kropp

NamnTypObligatoriskBeskrivning
panel_idnumber
obligatoriskt
ID för den enkla panel som ärendet ska flyttas till (se Lista paneler).
keep_permissionsboolean
valfritt
Behåller kanalens nuvarande rollbehörigheter utöver den nya panelens team (standard true). Sätt false för att låta bara den nya panelens supportteam ha tillgång.

Ärendelägena måste stämma överens: ärenden som är kanaler går bara att flytta till kanalbaserade paneler och ärenden som är trådar bara till trådbaserade paneler. Eftersom bytet byter namn på kanalen tillåter Discord det ungefär två gånger per 10 minuter; den här ändpunkten håller samma gräns och svarar 429 med retry_after när den överskrids.

Exempelanrop
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
Exempelsvar
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}