Belgeler

TicketsX'i daha hızlı öğren

Kurulum rehberleri, tüm komutlar, Premium özellikleri ve REST API tek yerde.

13.11

Panel güncelleme

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

Bir panelin ayarlarını değiştirir: ad, gömülü mesaj, renk, düğme görünümü ve otomatik kapatmayı yoksayıp yoksaymayacağı. Discord'daki panel mesajı kendiliğinden yenilenir. `manage_panels` yetkisi gerekir (varsayılan olarak kapalı).

İstek gövdesi (bütün alanlar isteğe bağlı; yalnızca değiştirmek istediklerinizi gönderin)

AdTürZorunluAçıklama
panel_titlestring|null
isteğe bağlı
Gömülü mesaj başlığı (en fazla 256 karakter). Temizlemek için null gönderin.
panel_descriptionstring|null
isteğe bağlı
Gömülü mesaj açıklaması (en fazla 4096 karakter). Temizlemek için null gönderin.
panel_contentstring|null
isteğe bağlı
Gömülü mesajın üstündeki düz metin (en fazla 2000 karakter). Temizlemek için null gönderin.
panel_footerstring|null
isteğe bağlı
Gömülü mesajın alt bilgi metni (en fazla 2048 karakter). Temizlemek için null gönderin.
panel_colorstring|null
isteğe bağlı
Gömülü mesaj rengi, onaltılık dizge olarak, örneğin #5865F2. Temizlemek için null gönderin.
panel_image_urlstring|null
isteğe bağlı
Gömülü mesaj görseli, http(s) adresi olarak. Temizlemek için null gönderin.
panel_thumbnail_urlstring|null
isteğe bağlı
Gömülü mesajın küçük görseli, http(s) adresi olarak. Temizlemek için null gönderin.
panel_namestring
isteğe bağlı
Talep adlandırmasında kullanılan panel adı (en fazla 100 karakter). Yalnızca tekli paneller.
button_textstring|null
isteğe bağlı
Düğme metni (en fazla 80 karakter). Yalnızca tekli paneller.
button_colorstring
isteğe bağlı
Düğme biçimi: primary, secondary, success veya danger. Yalnızca tekli paneller.
button_emojistring|null
isteğe bağlı
Düğme emojisi (unicode veya özel emoji kimliği). Yalnızca tekli paneller.
disabledboolean
isteğe bağlı
Paneli kapatır veya yeniden açar. Yalnızca tekli paneller.
bypass_auto_closeboolean
isteğe bağlı
Sunucuda otomatik kapatma açık olsa bile bu panelin taleplerini kapsam dışında bırakır. Yalnızca tekli paneller.
dropdown_placeholderstring|null
isteğe bağlı
Açılır listenin yer tutucu metni (en fazla 150 karakter). Yalnızca çoklu paneller.

Yapısal ayarlar (panel kanalı, talep kategorisi, etiketlenecek rol, formlar, ekipler) API üzerinden değiştirilemez; bunlar için paneli kullanın. Yanıt message_refreshed alanını içerir; değeri false ise (ya da çoklu panelde dropdown_placeholder alanını değiştirdiyseniz) Discord mesajını güncellemek için Paneli yeniden gönderme uç noktasını çağırın.

Bileşen düzeni kullanan paneller panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url ve panel_thumbnail_url alanlarını 400 hatasıyla reddeder. Bu panellerin düzenini web panelinden değiştirin.

İstek örneği
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>
Yanıt örneği
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}