Paneelin päivittäminen

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

Muuttaa paneelin määrityksiä: nimen, upotetun viestin, värin, painikkeen ulkoasun ja sen, ohittaako paneeli automaattisen sulkemisen. Discordissa oleva paneeliviesti päivittyy itsestään. Vaatii oikeuden `manage_panels` (oletuksena pois päältä).

Pyynnön runko (kaikki kentät valinnaisia; lähetä vain se, mitä haluat muuttaa)

Nimi	Tyyppi	Pakollinen	Kuvaus
panel_title	string\|null	valinnainen	Upotetun viestin otsikko (enintään 256 merkkiä). Tyhjennä lähettämällä `null`.
panel_description	string\|null	valinnainen	Upotetun viestin kuvaus (enintään 4096 merkkiä). Tyhjennä lähettämällä `null`.
panel_content	string\|null	valinnainen	Tavallinen teksti upotetun viestin yläpuolella (enintään 2000 merkkiä). Tyhjennä lähettämällä `null`.
panel_footer	string\|null	valinnainen	Upotetun viestin alatunnisteen teksti (enintään 2048 merkkiä). Tyhjennä lähettämällä `null`.
panel_color	string\|null	valinnainen	Upotetun viestin väri heksamerkkijonona, esimerkiksi `#5865F2`. Tyhjennä lähettämällä `null`.
panel_image_url	string\|null	valinnainen	Upotetun viestin kuva http(s)-osoitteena. Tyhjennä lähettämällä `null`.
panel_thumbnail_url	string\|null	valinnainen	Upotetun viestin pikkukuva http(s)-osoitteena. Tyhjennä lähettämällä `null`.
panel_name	string	valinnainen	Paneelin nimi, jota käytetään tikettien nimeämisessä (enintään 100 merkkiä). Vain yksittäiset paneelit.
button_text	string\|null	valinnainen	Painikkeen teksti (enintään 80 merkkiä). Vain yksittäiset paneelit.
button_color	string	valinnainen	Painikkeen tyyli: `primary`, `secondary`, `success` tai `danger`. Vain yksittäiset paneelit.
button_emoji	string\|null	valinnainen	Painikkeen emoji (unicode tai oman emojin tunnus). Vain yksittäiset paneelit.
disabled	boolean	valinnainen	Poistaa paneelin käytöstä tai ottaa sen taas käyttöön. Vain yksittäiset paneelit.
bypass_auto_close	boolean	valinnainen	Jättää tämän paneelin tiketit automaattisen sulkemisen ulkopuolelle, vaikka se olisi palvelimella käytössä. Vain yksittäiset paneelit.
dropdown_placeholder	string\|null	valinnainen	Valikon ohjeteksti (enintään 150 merkkiä). Vain monipaneelit.

Rakenteellisia asetuksia (paneelin kanava, tikettien kategoria, mainittava rooli, lomakkeet, tukitiimit) ei voi muuttaa rajapinnan kautta; käytä niihin hallintapaneelia. Vastauksessa on message_refreshed; jos sen arvo on false (tai muutit monipaneelin kenttää dropdown_placeholder), kutsu Paneelin lähettäminen uudelleen, jotta Discord-viesti päivittyy.

Komponenttiasettelua käyttävät paneelit hylkäävät kentät panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url ja panel_thumbnail_url virheellä 400. Muokkaa niiden asettelua hallintapaneelissa.

Esimerkkipyyntö

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>

Esimerkkivastaus

{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}