13.15
Tiketin paneelin vaihtaminen
POST
/<guild_id>/api/tickets/<ticket_id>/switch-panelSiirtää tiketin toiseen yksittäiseen paneeliin. Tämä vastaa rajapinnassa /switchpanel-komentoa. Tiketti nimetään uuden paneelin nimeämismallin mukaan, kanavatiketeissä se siirretään paneelin kategoriaan, ja uuden paneelin tukitiimit saavat pääsyn. Vaatii oikeuden `switch_panel` (oletuksena pois päältä).
Pyynnön runko
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| panel_id | number | pakollinen | Sen yksittäisen paneelin tunnus, johon tiketti siirretään (katso Paneelien listaus). |
| keep_permissions | boolean | valinnainen | Säilyttää kanavan nykyiset rooliokeudet uuden paneelin tiimien lisäksi (oletus true). Aseta false, jos haluat jättää pääsyn vain uuden paneelin tukitiimeille. |
Tikettitapojen pitää täsmätä: kanavatiketit voi siirtää vain kanavapohjaisiin paneeleihin ja ketjutiketit vain ketjupohjaisiin. Koska vaihto nimeää kanavan uudelleen, Discord sallii sen noin kahdesti 10 minuutissa; tämä päätepiste noudattaa samaa rajaa ja palauttaa 429 ja kentän retry_after, kun raja ylittyy.
Esimerkkipyyntö
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-panelEsimerkkivastaus
{
"message": "Panel switched to `Billing` successfully.",
"ticket_id": 42,
"panel_id": 2,
"keep_permissions": true
}