13.11
Opdater et panel
/<guild_id>/api/panels/<panel_id>Ændrer et panels opsætning: navn, indlejret besked, farve, knappens udseende, og om det springer automatisk lukning over. Panelbeskeden i Discord bliver opdateret automatisk. Kræver rettigheden `manage_panels` (slået fra som standard).
Kaldets indhold (alle felter er valgfrie; send kun det, du vil ændre)
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| panel_title | string|null | valgfrit | Titel i den indlejrede besked (højst 256 tegn). Send null for at tømme. |
| panel_description | string|null | valgfrit | Beskrivelse i den indlejrede besked (højst 4096 tegn). Send null for at tømme. |
| panel_content | string|null | valgfrit | Almindelig tekst over den indlejrede besked (højst 2000 tegn). Send null for at tømme. |
| panel_footer | string|null | valgfrit | Sidefodstekst i den indlejrede besked (højst 2048 tegn). Send null for at tømme. |
| panel_color | string|null | valgfrit | Farve på den indlejrede besked som hexstreng, for eksempel #5865F2. Send null for at tømme. |
| panel_image_url | string|null | valgfrit | Billede i den indlejrede besked som http(s)-adresse. Send null for at tømme. |
| panel_thumbnail_url | string|null | valgfrit | Miniature i den indlejrede besked som http(s)-adresse. Send null for at tømme. |
| panel_name | string | valgfrit | Panelnavnet, der bruges, når sager navngives (højst 100 tegn). Kun enkle paneler. |
| button_text | string|null | valgfrit | Knaptekst (højst 80 tegn). Kun enkle paneler. |
| button_color | string | valgfrit | Knapstil: primary, secondary, success eller danger. Kun enkle paneler. |
| button_emoji | string|null | valgfrit | Knapemoji (unicode eller id på en egen emoji). Kun enkle paneler. |
| disabled | boolean | valgfrit | Slår panelet fra eller til igen. Kun enkle paneler. |
| bypass_auto_close | boolean | valgfrit | Holder sager fra dette panel uden for automatisk lukning, også når den er slået til for serveren. Kun enkle paneler. |
| dropdown_placeholder | string|null | valgfrit | Pladsholdertekst i rullemenuen (højst 150 tegn). Kun flerknapspaneler. |
De strukturelle indstillinger (panelets kanal, sagskategori, rolle der skal nævnes, formularer, supportteams) kan ikke ændres gennem API'et; brug kontrolpanelet til dem. Svaret indeholder message_refreshed; er værdien false (eller har du ændret dropdown_placeholder på et flerknapspanel), skal du kalde Send et panel igen for at opdatere beskeden i Discord.
Paneler med et komponentlayout afviser panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url og panel_thumbnail_url med en 400-fejl. Ret i stedet deres layout i kontrolpanelet.
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"
}
}
}