Zmiana panelu

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

Zmienia ustawienia panelu: nazwę, osadzoną wiadomość, kolor, wygląd przycisku oraz to, czy panel pomija automatyczne zamykanie. Wiadomość panelu na Discordzie odświeża się sama. Wymaga uprawnienia `manage_panels` (domyślnie wyłączonego).

Ciało żądania (wszystkie pola opcjonalne, wyślij tylko to, co chcesz zmienić)

Nazwa	Typ	Wymagane	Opis
panel_title	string\|null	opcjonalne	Tytuł osadzonej wiadomości (do 256 znaków). Wyślij `null`, aby go usunąć.
panel_description	string\|null	opcjonalne	Opis osadzonej wiadomości (do 4096 znaków). Wyślij `null`, aby go usunąć.
panel_content	string\|null	opcjonalne	Zwykły tekst nad osadzoną wiadomością (do 2000 znaków). Wyślij `null`, aby go usunąć.
panel_footer	string\|null	opcjonalne	Tekst stopki osadzonej wiadomości (do 2048 znaków). Wyślij `null`, aby go usunąć.
panel_color	string\|null	opcjonalne	Kolor osadzonej wiadomości jako wartość szesnastkowa, na przykład `#5865F2`. Wyślij `null`, aby go usunąć.
panel_image_url	string\|null	opcjonalne	Obraz osadzonej wiadomości jako adres http(s). Wyślij `null`, aby go usunąć.
panel_thumbnail_url	string\|null	opcjonalne	Miniatura osadzonej wiadomości jako adres http(s). Wyślij `null`, aby ją usunąć.
panel_name	string	opcjonalne	Nazwa panelu używana przy nazywaniu zgłoszeń (do 100 znaków). Tylko panele pojedyncze.
button_text	string\|null	opcjonalne	Napis na przycisku (do 80 znaków). Tylko panele pojedyncze.
button_color	string	opcjonalne	Styl przycisku: `primary`, `secondary`, `success` albo `danger`. Tylko panele pojedyncze.
button_emoji	string\|null	opcjonalne	Emoji przycisku (unicode albo identyfikator własnego emoji). Tylko panele pojedyncze.
disabled	boolean	opcjonalne	Wyłącza panel albo włącza go ponownie. Tylko panele pojedyncze.
bypass_auto_close	boolean	opcjonalne	Wyłącza zgłoszenia z tego panelu z automatycznego zamykania, nawet gdy jest ono włączone dla serwera. Tylko panele pojedyncze.
dropdown_placeholder	string\|null	opcjonalne	Tekst podpowiedzi listy rozwijanej (do 150 znaków). Tylko panele wielokrotne.

Ustawień strukturalnych (kanał panelu, kategoria zgłoszeń, rola do oznaczenia, formularze, zespoły obsługi) nie da się zmienić przez API; użyj do tego panelu. Odpowiedź zawiera pole message_refreshed; jeśli ma wartość false (albo zmieniono dropdown_placeholder w panelu wielokrotnym), wywołaj ponowne wysłanie panelu, aby odświeżyć wiadomość na Discordzie.

Panele z układem komponentów odrzucają panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url i panel_thumbnail_url z błędem 400. Ich układ zmienisz w panelu sterowania.

Przykładowe żądanie

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>

Przykładowa odpowiedź

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