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

Опануй 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
необовʼязково
Емодзі кнопки (unicode або ідентифікатор власного емодзі). Лише для одиночних панелей.
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"
    }
  }
}