Dokumentacija

Nauči TicketsX brže

Upute za postavljanje, popis svih naredbi, mogućnosti Premiuma i REST API na jednom mjestu.

13.11

Izmjena panela

PATCH/<guild_id>/api/panels/<panel_id>

Mijenja postavu panela: naziv, ugrađenu poruku, boju, izgled gumba i to preskače li panel samostalno zatvaranje. Poruka panela na Discordu osvježava se sama. Traži ovlast `manage_panels` (zadano isključena).

Sadržaj zahtjeva (sva su polja neobavezna; šaljite samo ono što mijenjate)

NazivVrstaObaveznoOpis
panel_titlestring|null
neobavezno
Naslov ugrađene poruke (najviše 256 znakova). Pošaljite null da ga ispraznite.
panel_descriptionstring|null
neobavezno
Opis ugrađene poruke (najviše 4096 znakova). Pošaljite null da ga ispraznite.
panel_contentstring|null
neobavezno
Obični tekst iznad ugrađene poruke (najviše 2000 znakova). Pošaljite null da ga ispraznite.
panel_footerstring|null
neobavezno
Tekst podnožja ugrađene poruke (najviše 2048 znakova). Pošaljite null da ga ispraznite.
panel_colorstring|null
neobavezno
Boja ugrađene poruke kao heksadekadski niz, na primjer #5865F2. Pošaljite null da je ispraznite.
panel_image_urlstring|null
neobavezno
Slika ugrađene poruke kao http(s) adresa. Pošaljite null da je ispraznite.
panel_thumbnail_urlstring|null
neobavezno
Sličica ugrađene poruke kao http(s) adresa. Pošaljite null da je ispraznite.
panel_namestring
neobavezno
Naziv panela koji se koristi pri imenovanju tiketa (najviše 100 znakova). Samo jednostavni paneli.
button_textstring|null
neobavezno
Tekst gumba (najviše 80 znakova). Samo jednostavni paneli.
button_colorstring
neobavezno
Izgled gumba: primary, secondary, success ili danger. Samo jednostavni paneli.
button_emojistring|null
neobavezno
Emotikon gumba (unicode ili oznaka vlastitog emotikona). Samo jednostavni paneli.
disabledboolean
neobavezno
Isključuje panel ili ga ponovno uključuje. Samo jednostavni paneli.
bypass_auto_closeboolean
neobavezno
Ostavlja tikete s ovog panela izvan samostalnog zatvaranja, čak i kad je ono uključeno za poslužitelj. Samo jednostavni paneli.
dropdown_placeholderstring|null
neobavezno
Pomoćni tekst padajućeg izbornika (najviše 150 znakova). Samo višestruki paneli.

Postavke ustroja (kanal panela, kategorija tiketa, uloga za spominjanje, obrasci, timovi podrške) ne mijenjaju se preko API-ja; za njih koristite nadzornu ploču. Odgovor sadrži message_refreshed; ako je vrijednost false (ili ste na višestrukom panelu promijenili dropdown_placeholder), pozovite Ponovno slanje panela da se poruka na Discordu osvježi.

Paneli s rasporedom komponenti odbijaju panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url i panel_thumbnail_url uz pogrešku 400. Njihov raspored uredite u nadzornoj ploči.

Primjer zahtjeva
curl -X PATCH \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_title":"Contact Support","panel_color":"#57F287","button_text":"Get Help","button_color":"success"}' \
  https://api.ticketsx.xyz/<guild_id>/api/panels/<panel_id>
Primjer odgovora
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}