Dokumentation

Lær TicketsX hurtigere

Guider, alle kommandoer, Premium-funktioner og REST-API'et ét sted.

13.11

Opdater et panel

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

NavnTypePåkrævetBeskrivelse
panel_titlestring|null
valgfrit
Titel i den indlejrede besked (højst 256 tegn). Send null for at tømme.
panel_descriptionstring|null
valgfrit
Beskrivelse i den indlejrede besked (højst 4096 tegn). Send null for at tømme.
panel_contentstring|null
valgfrit
Almindelig tekst over den indlejrede besked (højst 2000 tegn). Send null for at tømme.
panel_footerstring|null
valgfrit
Sidefodstekst i den indlejrede besked (højst 2048 tegn). Send null for at tømme.
panel_colorstring|null
valgfrit
Farve på den indlejrede besked som hexstreng, for eksempel #5865F2. Send null for at tømme.
panel_image_urlstring|null
valgfrit
Billede i den indlejrede besked som http(s)-adresse. Send null for at tømme.
panel_thumbnail_urlstring|null
valgfrit
Miniature i den indlejrede besked som http(s)-adresse. Send null for at tømme.
panel_namestring
valgfrit
Panelnavnet, der bruges, når sager navngives (højst 100 tegn). Kun enkle paneler.
button_textstring|null
valgfrit
Knaptekst (højst 80 tegn). Kun enkle paneler.
button_colorstring
valgfrit
Knapstil: primary, secondary, success eller danger. Kun enkle paneler.
button_emojistring|null
valgfrit
Knapemoji (unicode eller id på en egen emoji). Kun enkle paneler.
disabledboolean
valgfrit
Slår panelet fra eller til igen. Kun enkle paneler.
bypass_auto_closeboolean
valgfrit
Holder sager fra dette panel uden for automatisk lukning, også når den er slået til for serveren. Kun enkle paneler.
dropdown_placeholderstring|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.

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