13.11
Обновяване на панел
/<guild_id>/api/panels/<panel_id>Променя настройката на панел: име, вградено съобщение, цвят, вид на бутона и дали панелът пропуска автоматичното затваряне. Съобщението на панела в Discord се обновява само. Изисква правото `manage_panels` (изключено по подразбиране).
Тяло на заявката (всички полета са по избор; пращайте само това, което искате да смените)
| Име | Тип | Задължително | Описание |
|---|---|---|---|
| panel_title | string|null | по избор | Заглавие на вграденото съобщение (до 256 знака). Пратете null, за да го изчистите. |
| panel_description | string|null | по избор | Описание на вграденото съобщение (до 4096 знака). Пратете null, за да го изчистите. |
| panel_content | string|null | по избор | Обикновен текст над вграденото съобщение (до 2000 знака). Пратете null, за да го изчистите. |
| panel_footer | string|null | по избор | Долен текст на вграденото съобщение (до 2048 знака). Пратете null, за да го изчистите. |
| panel_color | string|null | по избор | Цвят на вграденото съобщение като шестнадесетичен низ, например #5865F2. Пратете null, за да го изчистите. |
| panel_image_url | string|null | по избор | Изображение на вграденото съобщение като адрес http(s). Пратете null, за да го изчистите. |
| panel_thumbnail_url | string|null | по избор | Миниатюра на вграденото съобщение като адрес http(s). Пратете null, за да я изчистите. |
| panel_name | string | по избор | Името на панела, което се ползва при именуването на тикетите (до 100 знака). Само за единични панели. |
| button_text | string|null | по избор | Текст на бутона (до 80 знака). Само за единични панели. |
| button_color | string | по избор | Вид на бутона: primary, secondary, success или danger. Само за единични панели. |
| button_emoji | string|null | по избор | Емоджи на бутона (unicode или идентификатор на собствено емоджи). Само за единични панели. |
| disabled | boolean | по избор | Изключва панела или го включва отново. Само за единични панели. |
| bypass_auto_close | boolean | по избор | Оставя тикетите от този панел извън автоматичното затваряне, дори когато то е включено за сървъра. Само за единични панели. |
| dropdown_placeholder | string|null | по избор | Помощен текст на падащия списък (до 150 знака). Само за многобутонни панели. |
Устройствените настройки (канал на панела, категория на тикетите, роля за споменаване, формуляри, екипи по поддръжката) не се променят през API; за тях ползвайте таблото. Отговорът съдържа message_refreshed. Ако стойността е false (или сте сменили dropdown_placeholder при многобутонен панел), извикайте Повторно изпращане на панела, за да се обнови съобщението в Discord.
Панелите с оформление от компоненти отхвърлят panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url и panel_thumbnail_url с грешка 400. Променяйте оформлението им в таблото.
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"
}
}
}