Documentație

Învață TicketsX mai repede

Ghiduri de configurare, lista completă de comenzi, funcțiile Premium și API-ul REST într-un singur loc.

13.11

Actualizarea unui panou

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

Schimbă alcătuirea unui panou: numele, mesajul încorporat, culoarea, aspectul butonului și dacă panoul sare peste închiderea automată. Mesajul panoului din Discord se reîmprospătează singur. Cere permisiunea `manage_panels` (oprită din start).

Corpul cererii (toate câmpurile sunt opționale; trimite doar ce vrei să schimbi)

NumeTipObligatoriuDescriere
panel_titlestring|null
opțional
Titlul mesajului încorporat (cel mult 256 de caractere). Trimite null ca să îl golești.
panel_descriptionstring|null
opțional
Descrierea mesajului încorporat (cel mult 4096 de caractere). Trimite null ca să o golești.
panel_contentstring|null
opțional
Text simplu deasupra mesajului încorporat (cel mult 2000 de caractere). Trimite null ca să îl golești.
panel_footerstring|null
opțional
Textul din subsolul mesajului încorporat (cel mult 2048 de caractere). Trimite null ca să îl golești.
panel_colorstring|null
opțional
Culoarea mesajului încorporat, ca șir hexazecimal, de exemplu #5865F2. Trimite null ca să o golești.
panel_image_urlstring|null
opțional
Imaginea mesajului încorporat, ca adresă http(s). Trimite null ca să o golești.
panel_thumbnail_urlstring|null
opțional
Miniatura mesajului încorporat, ca adresă http(s). Trimite null ca să o golești.
panel_namestring
opțional
Numele panoului folosit la denumirea tichetelor (cel mult 100 de caractere). Doar la panourile simple.
button_textstring|null
opțional
Textul butonului (cel mult 80 de caractere). Doar la panourile simple.
button_colorstring
opțional
Stilul butonului: primary, secondary, success sau danger. Doar la panourile simple.
button_emojistring|null
opțional
Emoji-ul butonului (unicode sau ID-ul unui emoji propriu). Doar la panourile simple.
disabledboolean
opțional
Oprește panoul sau îl pornește la loc. Doar la panourile simple.
bypass_auto_closeboolean
opțional
Lasă tichetele din acest panou în afara închiderii automate, chiar dacă ea este pornită pe server. Doar la panourile simple.
dropdown_placeholderstring|null
opțional
Textul ajutător al listei derulante (cel mult 150 de caractere). Doar la panourile multiple.

Setările de structură (canalul panoului, categoria tichetelor, rolul menționat, formularele, echipele de asistență) nu pot fi schimbate prin API; pentru ele folosește panoul. Răspunsul include message_refreshed; dacă are valoarea false (sau dacă ai schimbat dropdown_placeholder la un panou multiplu), apelează Retrimiterea unui panou ca să actualizezi mesajul din Discord.

Panourile care folosesc o structură din componente resping panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url și panel_thumbnail_url cu eroarea 400. Editează structura lor din panou.

Exemplu de cerere
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>
Exemplu de răspuns
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}