Dokumentace

Nauč se TicketsX rychleji

Návody k nastavení, přehled všech příkazů, funkce Premium a REST API na jednom místě.

13.11

Úprava panelu

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

Změní nastavení panelu: název, vloženou zprávu, barvu, vzhled tlačítka a to, zda panel vynechává automatické zavírání. Zpráva panelu na Discordu se obnoví sama. Vyžaduje oprávnění `manage_panels` (ve výchozím stavu vypnuté).

Tělo požadavku (všechna pole jsou nepovinná, pošlete jen to, co chcete změnit)

NázevTypPovinnéPopis
panel_titlestring|null
volitelné
Nadpis vložené zprávy (nejvýše 256 znaků). Pošlete null pro vymazání.
panel_descriptionstring|null
volitelné
Popis vložené zprávy (nejvýše 4096 znaků). Pošlete null pro vymazání.
panel_contentstring|null
volitelné
Prostý text nad vloženou zprávou (nejvýše 2000 znaků). Pošlete null pro vymazání.
panel_footerstring|null
volitelné
Text zápatí vložené zprávy (nejvýše 2048 znaků). Pošlete null pro vymazání.
panel_colorstring|null
volitelné
Barva vložené zprávy jako šestnáctkový řetězec, třeba #5865F2. Pošlete null pro vymazání.
panel_image_urlstring|null
volitelné
Obrázek vložené zprávy jako adresa http(s). Pošlete null pro vymazání.
panel_thumbnail_urlstring|null
volitelné
Náhled vložené zprávy jako adresa http(s). Pošlete null pro vymazání.
panel_namestring
volitelné
Název panelu používaný při pojmenování tiketů (nejvýše 100 znaků). Jen jednoduché panely.
button_textstring|null
volitelné
Text tlačítka (nejvýše 80 znaků). Jen jednoduché panely.
button_colorstring
volitelné
Styl tlačítka: primary, secondary, success nebo danger. Jen jednoduché panely.
button_emojistring|null
volitelné
Emoji tlačítka (unicode nebo ID vlastního emoji). Jen jednoduché panely.
disabledboolean
volitelné
Vypne panel nebo ho zase zapne. Jen jednoduché panely.
bypass_auto_closeboolean
volitelné
Vynechá tikety z tohoto panelu z automatického zavírání, i když je pro server zapnuté. Jen jednoduché panely.
dropdown_placeholderstring|null
volitelné
Text nápovědy v rozbalovací nabídce (nejvýše 150 znaků). Jen vícenásobné panely.

Strukturní nastavení (kanál panelu, kategorie tiketů, role k označení, formuláře, týmy podpory) přes API měnit nejde; na to použijte nástěnku. Odpověď obsahuje pole message_refreshed; pokud má hodnotu false (nebo jste u vícenásobného panelu změnili dropdown_placeholder), zavolejte Odeslání panelu znovu, ať se zpráva na Discordu obnoví.

Panely s rozvržením z komponent odmítnou panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url a panel_thumbnail_url s chybou 400. Jejich rozvržení upravte na nástěnce.

Příklad požadavku
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>
Příklad odpovědi
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}