Ενημέρωση πίνακα

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

Αλλάζει τη ρύθμιση ενός πίνακα: όνομα, ενσωματωμένο μήνυμα, χρώμα, εμφάνιση κουμπιού και αν ο πίνακας παραβλέπει το αυτόματο κλείσιμο. Το μήνυμα του πίνακα στο Discord ανανεώνεται μόνο του. Απαιτεί το δικαίωμα `manage_panels` (εξαρχής ανενεργό).

Σώμα αιτήματος (όλα τα πεδία προαιρετικά· στείλε μόνο όσα θέλεις να αλλάξεις)

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
panel_title	string\|null	προαιρετικό	Τίτλος ενσωματωμένου μηνύματος (έως 256 χαρακτήρες). Στείλε `null` για να τον σβήσεις.
panel_description	string\|null	προαιρετικό	Περιγραφή ενσωματωμένου μηνύματος (έως 4096 χαρακτήρες). Στείλε `null` για να τη σβήσεις.
panel_content	string\|null	προαιρετικό	Απλό κείμενο πάνω από το ενσωματωμένο μήνυμα (έως 2000 χαρακτήρες). Στείλε `null` για να το σβήσεις.
panel_footer	string\|null	προαιρετικό	Κείμενο υποσέλιδου του ενσωματωμένου μηνύματος (έως 2048 χαρακτήρες). Στείλε `null` για να το σβήσεις.
panel_color	string\|null	προαιρετικό	Χρώμα ενσωματωμένου μηνύματος ως δεκαεξαδική συμβολοσειρά, για παράδειγμα `#5865F2`. Στείλε `null` για να το σβήσεις.
panel_image_url	string\|null	προαιρετικό	Εικόνα ενσωματωμένου μηνύματος ως διεύθυνση http(s). Στείλε `null` για να τη σβήσεις.
panel_thumbnail_url	string\|null	προαιρετικό	Μικρογραφία ενσωματωμένου μηνύματος ως διεύθυνση http(s). Στείλε `null` για να τη σβήσεις.
panel_name	string	προαιρετικό	Το όνομα πίνακα που χρησιμοποιείται στην ονομασία των αιτημάτων (έως 100 χαρακτήρες). Μόνο σε απλούς πίνακες.
button_text	string\|null	προαιρετικό	Κείμενο κουμπιού (έως 80 χαρακτήρες). Μόνο σε απλούς πίνακες.
button_color	string	προαιρετικό	Στυλ κουμπιού: `primary`, `secondary`, `success` ή `danger`. Μόνο σε απλούς πίνακες.
button_emoji	string\|null	προαιρετικό	Emoji κουμπιού (unicode ή αναγνωριστικό προσαρμοσμένου emoji). Μόνο σε απλούς πίνακες.
disabled	boolean	προαιρετικό	Απενεργοποιεί ή ενεργοποιεί ξανά τον πίνακα. Μόνο σε απλούς πίνακες.
bypass_auto_close	boolean	προαιρετικό	Αφήνει τα αιτήματα αυτού του πίνακα έξω από το αυτόματο κλείσιμο, ακόμη κι όταν είναι ενεργό για τον διακομιστή. Μόνο σε απλούς πίνακες.
dropdown_placeholder	string\|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"
    }
  }
}