Dokumentasi

Kuasai TicketsX lebih cepat

Panduan pemasangan, daftar lengkap perintah, fitur Premium, dan REST API dalam satu tempat.

13.11

Memperbarui panel

PATCH/<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)

NamaJenisWajibKeterangan
panel_titlestring|null
opsional
Judul pesan sematan (maks 256 karakter). Kirim null untuk mengosongkan.
panel_descriptionstring|null
opsional
Deskripsi pesan sematan (maks 4096 karakter). Kirim null untuk mengosongkan.
panel_contentstring|null
opsional
Teks biasa di atas pesan sematan (maks 2000 karakter). Kirim null untuk mengosongkan.
panel_footerstring|null
opsional
Teks catatan kaki pesan sematan (maks 2048 karakter). Kirim null untuk mengosongkan.
panel_colorstring|null
opsional
Warna pesan sematan berupa untai heksa, misalnya #5865F2. Kirim null untuk mengosongkan.
panel_image_urlstring|null
opsional
Gambar pesan sematan berupa alamat http(s). Kirim null untuk mengosongkan.
panel_thumbnail_urlstring|null
opsional
Gambar kecil pesan sematan berupa alamat http(s). Kirim null untuk mengosongkan.
panel_namestring
opsional
Nama panel yang dipakai untuk penamaan tiket (maks 100 karakter). Hanya panel tunggal.
button_textstring|null
opsional
Teks tombol (maks 80 karakter). Hanya panel tunggal.
button_colorstring
opsional
Gaya tombol: primary, secondary, success, atau danger. Hanya panel tunggal.
button_emojistring|null
opsional
Emoji tombol (unicode atau ID emoji khusus). Hanya panel tunggal.
disabledboolean
opsional
Mematikan atau menyalakan kembali panelnya. Hanya panel tunggal.
bypass_auto_closeboolean
opsional
Mengeluarkan tiket dari panel ini dari penutupan otomatis, bahkan ketika penutupan otomatis menyala untuk server. Hanya panel tunggal.
dropdown_placeholderstring|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.

Contoh permintaan
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>
Contoh respons
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}