13.11
Úprava panelu
/<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ázev | Typ | Povinné | Popis |
|---|---|---|---|
| panel_title | string|null | volitelné | Nadpis vložené zprávy (nejvýše 256 znaků). Pošlete null pro vymazání. |
| panel_description | string|null | volitelné | Popis vložené zprávy (nejvýše 4096 znaků). Pošlete null pro vymazání. |
| panel_content | string|null | volitelné | Prostý text nad vloženou zprávou (nejvýše 2000 znaků). Pošlete null pro vymazání. |
| panel_footer | string|null | volitelné | Text zápatí vložené zprávy (nejvýše 2048 znaků). Pošlete null pro vymazání. |
| panel_color | string|null | volitelné | Barva vložené zprávy jako šestnáctkový řetězec, třeba #5865F2. Pošlete null pro vymazání. |
| panel_image_url | string|null | volitelné | Obrázek vložené zprávy jako adresa http(s). Pošlete null pro vymazání. |
| panel_thumbnail_url | string|null | volitelné | Náhled vložené zprávy jako adresa http(s). Pošlete null pro vymazání. |
| panel_name | string | volitelné | Název panelu používaný při pojmenování tiketů (nejvýše 100 znaků). Jen jednoduché panely. |
| button_text | string|null | volitelné | Text tlačítka (nejvýše 80 znaků). Jen jednoduché panely. |
| button_color | string | volitelné | Styl tlačítka: primary, secondary, success nebo danger. Jen jednoduché panely. |
| button_emoji | string|null | volitelné | Emoji tlačítka (unicode nebo ID vlastního emoji). Jen jednoduché panely. |
| disabled | boolean | volitelné | Vypne panel nebo ho zase zapne. Jen jednoduché panely. |
| bypass_auto_close | boolean | volitelné | Vynechá tikety z tohoto panelu z automatického zavírání, i když je pro server zapnuté. Jen jednoduché panely. |
| dropdown_placeholder | string|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.
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>{
"message": "Panel updated",
"message_refreshed": true,
"panel": {
"PanelId": 1,
"Type": "single",
"PanelName": "Support",
"PanelMessage": {
"PanelTitle": "Contact Support",
"PanelColor": "#57F287",
"ButtonText": "Get Help",
"ButtonColor": "success"
}
}
}