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"
}
}
}