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 | необязательно | Эмодзи кнопки (юникод или ID пользовательского эмодзи). Только для одиночных панелей. |
| 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"
}
}
}