패널 수정

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

패널 구성을 바꿉니다. 이름, 임베드 메시지, 색, 버튼 모양, 자동 닫기 제외 여부를 지정할 수 있습니다. Discord에 올라가 있는 패널 메시지는 자동으로 갱신됩니다. `manage_panels` 권한이 필요합니다(기본값은 꺼짐).

요청 본문(모든 항목은 선택입니다. 바꿀 항목만 보내세요)

이름	형식	필수	설명
panel_title	string\|null	선택	임베드 제목(최대 256자). 지우려면 `null`을 보냅니다.
panel_description	string\|null	선택	임베드 설명(최대 4096자). 지우려면 `null`을 보냅니다.
panel_content	string\|null	선택	임베드 위에 표시되는 일반 텍스트(최대 2000자). 지우려면 `null`을 보냅니다.
panel_footer	string\|null	선택	임베드 푸터 문구(최대 2048자). 지우려면 `null`을 보냅니다.
panel_color	string\|null	선택	임베드 색. `#5865F2` 같은 16진수 문자열입니다. 지우려면 `null`을 보냅니다.
panel_image_url	string\|null	선택	임베드 이미지. http(s) URL로 지정합니다. 지우려면 `null`을 보냅니다.
panel_thumbnail_url	string\|null	선택	임베드 썸네일. http(s) URL로 지정합니다. 지우려면 `null`을 보냅니다.
panel_name	string	선택	티켓 이름을 짓는 데 쓰이는 패널 이름(최대 100자). 단일 패널에만 해당합니다.
button_text	string\|null	선택	버튼 문구(최대 80자). 단일 패널에만 해당합니다.
button_color	string	선택	버튼 모양: `primary`, `secondary`, `success`, `danger` 중 하나. 단일 패널에만 해당합니다.
button_emoji	string\|null	선택	버튼 이모지(유니코드 또는 커스텀 이모지 ID). 단일 패널에만 해당합니다.
disabled	boolean	선택	패널을 끄거나 다시 켭니다. 단일 패널에만 해당합니다.
bypass_auto_close	boolean	선택	서버에 자동 닫기가 켜져 있어도 이 패널의 티켓은 자동 닫기에서 제외합니다. 단일 패널에만 해당합니다.
dropdown_placeholder	string\|null	선택	드롭다운 안내 문구(최대 150자). 다중 패널에만 해당합니다.

구조에 해당하는 설정(패널 채널, 티켓 카테고리, 멘션 역할, 양식, 지원팀)은 API로 바꿀 수 없습니다. 그런 항목은 대시보드에서 바꾸세요. 응답에는 message_refreshed가 들어갑니다. 값이 false이거나 다중 패널에서 dropdown_placeholder를 바꿨다면 패널 다시 보내기를 호출해 Discord 메시지를 갱신하세요.

컴포넌트 레이아웃을 쓰는 패널은 panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url, panel_thumbnail_url을 보내면 400 오류로 거부합니다. 이런 패널의 레이아웃은 대시보드에서 수정하세요.

요청 예시

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>

응답 예시

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