Dokumentace

Nauč se TicketsX rychleji

Návody k nastavení, přehled všech příkazů, funkce Premium a REST API na jednom místě.

13.15

Změna panelu tiketu

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

Přesune tiket pod jiný jednoduchý panel. Jde o obdobu příkazu /switchpanel v API. Tiket se přejmenuje podle schématu nového panelu, u tiketů v kanálech se přesune do jeho kategorie a týmy podpory nového panelu dostanou přístup. Vyžaduje oprávnění `switch_panel` (ve výchozím stavu vypnuté).

Tělo požadavku

NázevTypPovinnéPopis
panel_idnumber
povinné
ID jednoduchého panelu, pod který se tiket přesune (viz Výpis panelů).
keep_permissionsboolean
volitelné
Ponechá na kanálu stávající oprávnění rolí navíc k týmům nového panelu (výchozí true). Nastavte false, ať přístup zůstane jen týmům podpory nového panelu.

Režimy tiketů musí souhlasit: tikety v kanálech lze přesunout jen pod panely s kanály a tikety ve vláknech jen pod panely s vlákny. Protože změna panelu přejmenuje kanál, Discord ji omezuje zhruba na dvakrát za 10 minut; tento koncový bod drží stejný limit a při jeho překročení vrací 429 s polem retry_after.

Příklad požadavku
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
Příklad odpovědi
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}