13.11
Memperbarui panel
/<guild_id>/api/panels/<panel_id>Mengubah pengaturan panel: nama, pesan sematan, warna, tampilan tombol, dan apakah panel mengabaikan penutupan otomatis. Pesan panel di Discord diperbarui sendiri. Butuh izin `manage_panels` (bawaannya mati).
Isi permintaan (semua kolom opsional; kirim hanya yang ingin Anda ubah)
| Nama | Jenis | Wajib | Keterangan |
|---|---|---|---|
| panel_title | string|null | opsional | Judul pesan sematan (maks 256 karakter). Kirim null untuk mengosongkan. |
| panel_description | string|null | opsional | Deskripsi pesan sematan (maks 4096 karakter). Kirim null untuk mengosongkan. |
| panel_content | string|null | opsional | Teks biasa di atas pesan sematan (maks 2000 karakter). Kirim null untuk mengosongkan. |
| panel_footer | string|null | opsional | Teks catatan kaki pesan sematan (maks 2048 karakter). Kirim null untuk mengosongkan. |
| panel_color | string|null | opsional | Warna pesan sematan berupa untai heksa, misalnya #5865F2. Kirim null untuk mengosongkan. |
| panel_image_url | string|null | opsional | Gambar pesan sematan berupa alamat http(s). Kirim null untuk mengosongkan. |
| panel_thumbnail_url | string|null | opsional | Gambar kecil pesan sematan berupa alamat http(s). Kirim null untuk mengosongkan. |
| panel_name | string | opsional | Nama panel yang dipakai untuk penamaan tiket (maks 100 karakter). Hanya panel tunggal. |
| button_text | string|null | opsional | Teks tombol (maks 80 karakter). Hanya panel tunggal. |
| button_color | string | opsional | Gaya tombol: primary, secondary, success, atau danger. Hanya panel tunggal. |
| button_emoji | string|null | opsional | Emoji tombol (unicode atau ID emoji khusus). Hanya panel tunggal. |
| disabled | boolean | opsional | Mematikan atau menyalakan kembali panelnya. Hanya panel tunggal. |
| bypass_auto_close | boolean | opsional | Mengeluarkan tiket dari panel ini dari penutupan otomatis, bahkan ketika penutupan otomatis menyala untuk server. Hanya panel tunggal. |
| dropdown_placeholder | string|null | opsional | Teks bantuan daftar pilihan (maks 150 karakter). Hanya panel ganda. |
Setelan struktural (kanal panel, kategori tiket, peran yang disebut, formulir, tim dukungan) tidak bisa diubah lewat API; pakai dasbor untuk itu. Responsnya memuat message_refreshed; kalau nilainya false (atau Anda mengubah dropdown_placeholder pada panel ganda), panggil Kirim Ulang Panel supaya pesan di Discord ikut diperbarui.
Panel yang memakai tata letak komponen menolak panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url, dan panel_thumbnail_url dengan kesalahan 400. Ubah tata letaknya di dasbor saja.
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"
}
}
}