Документация

Освой TicketsX быстрее

Инструкции по настройке, полный справочник команд, Premium-функции и REST API в одном месте.

13.11

Обновить панель

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

Меняет настройки панели: название, встроенное сообщение, цвет, оформление кнопок и то, игнорирует ли она автозакрытие. Опубликованное в Discord сообщение панели обновляется автоматически. Требует права `manage_panels` (по умолчанию отключено).

Тело запроса (все поля необязательны, отправляй только то, что меняешь)

НазваниеТипОбязательноОписание
panel_titlestring|null
необязательно
Заголовок встроенного сообщения (до 256 символов). Отправь null, чтобы очистить.
panel_descriptionstring|null
необязательно
Описание встроенного сообщения (до 4096 символов). Отправь null, чтобы очистить.
panel_contentstring|null
необязательно
Обычный текст над встроенным сообщением (до 2000 символов). Отправь null, чтобы очистить.
panel_footerstring|null
необязательно
Текст подвала встроенного сообщения (до 2048 символов). Отправь null, чтобы очистить.
panel_colorstring|null
необязательно
Цвет встроенного сообщения в шестнадцатеричном виде, например #5865F2. Отправь null, чтобы очистить.
panel_image_urlstring|null
необязательно
Изображение встроенного сообщения как http(s)-ссылка. Отправь null, чтобы очистить.
panel_thumbnail_urlstring|null
необязательно
Миниатюра встроенного сообщения как http(s)-ссылка. Отправь null, чтобы очистить.
panel_namestring
необязательно
Название панели, по которому именуются тикеты (до 100 символов). Только для одиночных панелей.
button_textstring|null
необязательно
Надпись на кнопке (до 80 символов). Только для одиночных панелей.
button_colorstring
необязательно
Стиль кнопки: primary, secondary, success или danger. Только для одиночных панелей.
button_emojistring|null
необязательно
Эмодзи кнопки (юникод или ID пользовательского эмодзи). Только для одиночных панелей.
disabledboolean
необязательно
Отключает или снова включает панель. Только для одиночных панелей.
bypass_auto_closeboolean
необязательно
Исключает тикеты этой панели из автозакрытия, даже если оно включено для сервера. Только для одиночных панелей.
dropdown_placeholderstring|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"
    }
  }
}