Dokumentacja

Poznaj TicketsX szybciej

Poradniki konfiguracji, pełny spis komend, funkcje Premium i API REST w jednym miejscu.

13.15

Zmiana panelu zgłoszenia

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

Przenosi zgłoszenie do innego panelu pojedynczego. To odpowiednik komendy /switchpanel w API. Zgłoszenie dostaje nazwę zgodną ze schematem nowego panelu, trafia do jego kategorii (w zgłoszeniach na kanałach), a zespoły obsługi nowego panelu dostają dostęp. Wymaga uprawnienia `switch_panel` (domyślnie wyłączonego).

Ciało żądania

NazwaTypWymaganeOpis
panel_idnumber
wymagane
Identyfikator panelu pojedynczego, do którego trafi zgłoszenie (zobacz Listę paneli).
keep_permissionsboolean
opcjonalne
Zachowuje dotychczasowe uprawnienia ról na kanale obok zespołów z nowego panelu (domyślnie true). Ustaw false, aby zostawić dostęp wyłącznie zespołom obsługi z nowego panelu.

Tryby zgłoszeń muszą się zgadzać: zgłoszenia na kanałach trafiają tylko do paneli kanałowych, a zgłoszenia w wątkach tylko do paneli wątkowych. Ponieważ zmiana panelu zmienia też nazwę kanału, Discord pozwala na to mniej więcej dwa razy na 10 minut; ten punkt końcowy trzyma się tego samego limitu i po jego przekroczeniu zwraca 429 z polem retry_after.

Przykładowe żądanie
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
Przykładowa odpowiedź
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}