Dokumentáció

Tanuld meg gyorsabban a TicketsX-et

Beállítási útmutatók, a teljes parancslista, a Premium funkciói és a REST API egy helyen.

13.15

Jegy paneljének cseréje

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

Áthelyez egy jegyet egy másik egyszerű panelhez. Ez a /switchpanel parancs megfelelője az API-ban. A jegy az új panel elnevezési mintája szerint kap nevet, csatornás jegyeknél átkerül a kategóriájába, és az új panel támogatói csapatai hozzáférést kapnak. `switch_panel` jogosultságot igényel (alapból kikapcsolva).

A kérés törzse

NévTípusKötelezőLeírás
panel_idnumber
kötelező
Annak az egyszerű panelnek az azonosítója, amelyhez a jegy kerül (lásd a Panelek listázását).
keep_permissionsboolean
nem kötelező
Megtartja a csatorna mostani rangjogosultságait az új panel csapatai mellett (alapból true). Állítsd false értékre, hogy csak az új panel támogatói csapatainak maradjon hozzáférése.

A jegyek módjának egyeznie kell: a csatornás jegyek csak csatornaalapú panelekhez, a szálas jegyek csak szálalapú panelekhez kerülhetnek át. Mivel a csere átnevezi a csatornát, a Discord ezt is nagyjából 10 percenként kétszer engedi; ez a végpont ugyanezt a korlátot tartja, és túllépéskor 429 választ ad retry_after mezővel.

Példa kérés
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élda válasz
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}