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

Научи 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"
    }
  }
}