Skydelio keitimas

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

Keičia skydelio nustatymus: pavadinimą, įterptinę žinutę, spalvą, mygtuko išvaizdą ir tai, ar skydelis nepaiso savaiminio uždarymo. Skydelio žinutė Discord atnaujinama savaime. Reikia teisės `manage_panels` (numatytai išjungta).

Užklausos turinys (visi laukai nebūtini; siųskite tik tai, ką norite pakeisti)

Pavadinimas	Tipas	Privaloma	Aprašas
panel_title	string\|null	neprivaloma	Įterptinės žinutės antraštė (daugiausia 256 rašmenys). Siųskite `null`, kad išvalytumėte.
panel_description	string\|null	neprivaloma	Įterptinės žinutės aprašas (daugiausia 4096 rašmenys). Siųskite `null`, kad išvalytumėte.
panel_content	string\|null	neprivaloma	Paprastas tekstas virš įterptinės žinutės (daugiausia 2000 rašmenų). Siųskite `null`, kad išvalytumėte.
panel_footer	string\|null	neprivaloma	Įterptinės žinutės poraštės tekstas (daugiausia 2048 rašmenys). Siųskite `null`, kad išvalytumėte.
panel_color	string\|null	neprivaloma	Įterptinės žinutės spalva šešioliktaine eilute, pavyzdžiui, `#5865F2`. Siųskite `null`, kad išvalytumėte.
panel_image_url	string\|null	neprivaloma	Įterptinės žinutės paveikslėlis http(s) adresu. Siųskite `null`, kad išvalytumėte.
panel_thumbnail_url	string\|null	neprivaloma	Įterptinės žinutės miniatiūra http(s) adresu. Siųskite `null`, kad išvalytumėte.
panel_name	string	neprivaloma	Skydelio pavadinimas, naudojamas bilietams pavadinti (daugiausia 100 rašmenų). Tik paprastiems skydeliams.
button_text	string\|null	neprivaloma	Mygtuko tekstas (daugiausia 80 rašmenų). Tik paprastiems skydeliams.
button_color	string	neprivaloma	Mygtuko išvaizda: `primary`, `secondary`, `success` arba `danger`. Tik paprastiems skydeliams.
button_emoji	string\|null	neprivaloma	Mygtuko jaustukas (unikodas arba savo jaustuko identifikatorius). Tik paprastiems skydeliams.
disabled	boolean	neprivaloma	Išjungia skydelį arba vėl jį įjungia. Tik paprastiems skydeliams.
bypass_auto_close	boolean	neprivaloma	Palieka šio skydelio bilietus už savaiminio uždarymo ribų, net kai serveryje jis įjungtas. Tik paprastiems skydeliams.
dropdown_placeholder	string\|null	neprivaloma	Išskleidžiamo sąrašo pagalbinis tekstas (daugiausia 150 rašmenų). Tik keliamygtukiams skydeliams.

Sandaros nustatymų (skydelio kanalo, bilietų kategorijos, paminimos rolės, formų, pagalbos komandų) per API pakeisti negalima; jiems naudokite valdymo pultą. Atsakyme būna message_refreshed; jei reikšmė yra false (arba keliamygtukiame skydelyje pakeitėte dropdown_placeholder), iškvieskite Skydelio siuntimą iš naujo, kad žinutė Discord būtų atnaujinta.

Skydeliai, naudojantys komponentų išdėstymą, atmeta panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url ir panel_thumbnail_url su klaida 400. Jų išdėstymą keiskite valdymo pulte.

Užklausos pavyzdys

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>

Atsakymo pavyzdys

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