13.11
Panel güncelleme
/<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)
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| panel_title | string|null | isteğe bağlı | Gömülü mesaj başlığı (en fazla 256 karakter). Temizlemek için null gönderin. |
| panel_description | string|null | isteğe bağlı | Gömülü mesaj açıklaması (en fazla 4096 karakter). Temizlemek için null gönderin. |
| panel_content | string|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_footer | string|null | isteğe bağlı | Gömülü mesajın alt bilgi metni (en fazla 2048 karakter). Temizlemek için null gönderin. |
| panel_color | string|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_url | string|null | isteğe bağlı | Gömülü mesaj görseli, http(s) adresi olarak. Temizlemek için null gönderin. |
| panel_thumbnail_url | string|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_name | string | isteğe bağlı | Talep adlandırmasında kullanılan panel adı (en fazla 100 karakter). Yalnızca tekli paneller. |
| button_text | string|null | isteğe bağlı | Düğme metni (en fazla 80 karakter). Yalnızca tekli paneller. |
| button_color | string | isteğe bağlı | Düğme biçimi: primary, secondary, success veya danger. Yalnızca tekli paneller. |
| button_emoji | string|null | isteğe bağlı | Düğme emojisi (unicode veya özel emoji kimliği). Yalnızca tekli paneller. |
| disabled | boolean | isteğe bağlı | Paneli kapatır veya yeniden açar. Yalnızca tekli paneller. |
| bypass_auto_close | boolean | 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_placeholder | string|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.
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"
}
}
}