Panel módosítása

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

Megváltoztatja egy panel beállításait: a nevet, a beágyazott üzenetet, a színt, a gomb megjelenését, és azt, hogy a panel kihagyja-e az automatikus lezárást. A Discordon lévő panelüzenet magától frissül. `manage_panels` jogosultságot igényel (alapból kikapcsolva).

A kérés törzse (minden mező nem kötelező; csak azt küldd el, amit módosítanál)

Név	Típus	Kötelező	Leírás
panel_title	string\|null	nem kötelező	A beágyazott üzenet címe (legfeljebb 256 karakter). Küldj `null` értéket a törléséhez.
panel_description	string\|null	nem kötelező	A beágyazott üzenet leírása (legfeljebb 4096 karakter). Küldj `null` értéket a törléséhez.
panel_content	string\|null	nem kötelező	Egyszerű szöveg a beágyazott üzenet fölött (legfeljebb 2000 karakter). Küldj `null` értéket a törléséhez.
panel_footer	string\|null	nem kötelező	A beágyazott üzenet láblécének szövege (legfeljebb 2048 karakter). Küldj `null` értéket a törléséhez.
panel_color	string\|null	nem kötelező	A beágyazott üzenet színe hexadecimális karakterláncként, például `#5865F2`. Küldj `null` értéket a törléséhez.
panel_image_url	string\|null	nem kötelező	A beágyazott üzenet képe http(s) hivatkozásként. Küldj `null` értéket a törléséhez.
panel_thumbnail_url	string\|null	nem kötelező	A beágyazott üzenet bélyegképe http(s) hivatkozásként. Küldj `null` értéket a törléséhez.
panel_name	string	nem kötelező	A jegyek elnevezéséhez használt panelnév (legfeljebb 100 karakter). Csak egyszerű paneleknél.
button_text	string\|null	nem kötelező	A gomb szövege (legfeljebb 80 karakter). Csak egyszerű paneleknél.
button_color	string	nem kötelező	A gomb stílusa: `primary`, `secondary`, `success` vagy `danger`. Csak egyszerű paneleknél.
button_emoji	string\|null	nem kötelező	A gomb hangulatjele (unicode vagy egyedi hangulatjel azonosítója). Csak egyszerű paneleknél.
disabled	boolean	nem kötelező	Kikapcsolja vagy újra bekapcsolja a panelt. Csak egyszerű paneleknél.
bypass_auto_close	boolean	nem kötelező	Kihagyja a panel jegyeit az automatikus lezárásból, még akkor is, ha az be van kapcsolva a szerveren. Csak egyszerű paneleknél.
dropdown_placeholder	string\|null	nem kötelező	A legördülő lista súgószövege (legfeljebb 150 karakter). Csak többgombos paneleknél.

A szerkezeti beállítások (a panel csatornája, a jegyek kategóriája, az említendő rang, az űrlapok, a támogatói csapatok) nem módosíthatók az API-n keresztül; azokhoz használd a vezérlőpultot. A válasz tartalmazza a message_refreshed mezőt; ha az értéke false (vagy többgombos panelnél átírtad a dropdown_placeholder mezőt), hívd meg a Panel újraküldését, hogy a Discord-üzenet is frissüljön.

A komponensekből álló elrendezést használó panelek 400-as hibával elutasítják a panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url és panel_thumbnail_url mezőket. Ezek elrendezését a vezérlőpulton szerkeszd.

Példa kérés

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>

Példa válasz

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