13.11
Actualizarea unui panou
/<guild_id>/api/panels/<panel_id>Schimbă alcătuirea unui panou: numele, mesajul încorporat, culoarea, aspectul butonului și dacă panoul sare peste închiderea automată. Mesajul panoului din Discord se reîmprospătează singur. Cere permisiunea `manage_panels` (oprită din start).
Corpul cererii (toate câmpurile sunt opționale; trimite doar ce vrei să schimbi)
| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| panel_title | string|null | opțional | Titlul mesajului încorporat (cel mult 256 de caractere). Trimite null ca să îl golești. |
| panel_description | string|null | opțional | Descrierea mesajului încorporat (cel mult 4096 de caractere). Trimite null ca să o golești. |
| panel_content | string|null | opțional | Text simplu deasupra mesajului încorporat (cel mult 2000 de caractere). Trimite null ca să îl golești. |
| panel_footer | string|null | opțional | Textul din subsolul mesajului încorporat (cel mult 2048 de caractere). Trimite null ca să îl golești. |
| panel_color | string|null | opțional | Culoarea mesajului încorporat, ca șir hexazecimal, de exemplu #5865F2. Trimite null ca să o golești. |
| panel_image_url | string|null | opțional | Imaginea mesajului încorporat, ca adresă http(s). Trimite null ca să o golești. |
| panel_thumbnail_url | string|null | opțional | Miniatura mesajului încorporat, ca adresă http(s). Trimite null ca să o golești. |
| panel_name | string | opțional | Numele panoului folosit la denumirea tichetelor (cel mult 100 de caractere). Doar la panourile simple. |
| button_text | string|null | opțional | Textul butonului (cel mult 80 de caractere). Doar la panourile simple. |
| button_color | string | opțional | Stilul butonului: primary, secondary, success sau danger. Doar la panourile simple. |
| button_emoji | string|null | opțional | Emoji-ul butonului (unicode sau ID-ul unui emoji propriu). Doar la panourile simple. |
| disabled | boolean | opțional | Oprește panoul sau îl pornește la loc. Doar la panourile simple. |
| bypass_auto_close | boolean | opțional | Lasă tichetele din acest panou în afara închiderii automate, chiar dacă ea este pornită pe server. Doar la panourile simple. |
| dropdown_placeholder | string|null | opțional | Textul ajutător al listei derulante (cel mult 150 de caractere). Doar la panourile multiple. |
Setările de structură (canalul panoului, categoria tichetelor, rolul menționat, formularele, echipele de asistență) nu pot fi schimbate prin API; pentru ele folosește panoul. Răspunsul include message_refreshed; dacă are valoarea false (sau dacă ai schimbat dropdown_placeholder la un panou multiplu), apelează Retrimiterea unui panou ca să actualizezi mesajul din Discord.
Panourile care folosesc o structură din componente resping panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url și panel_thumbnail_url cu eroarea 400. Editează structura lor din panou.
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"
}
}
}