Cập nhật bảng

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

Đổi phần thiết lập của bảng: tên, tin nhắn nhúng, màu, dáng vẻ của nút và việc bảng có bỏ qua đóng tự động hay không. Tin nhắn bảng trên Discord tự làm mới. Cần quyền `manage_panels` (mặc định tắt).

Thân yêu cầu (mọi trường đều tùy chọn; chỉ gửi những gì bạn muốn đổi)

Tên	Kiểu	Bắt buộc	Mô tả
panel_title	string\|null	tùy chọn	Tiêu đề tin nhắn nhúng (tối đa 256 ký tự). Gửi `null` để xóa trắng.
panel_description	string\|null	tùy chọn	Mô tả tin nhắn nhúng (tối đa 4096 ký tự). Gửi `null` để xóa trắng.
panel_content	string\|null	tùy chọn	Chữ thường nằm phía trên tin nhắn nhúng (tối đa 2000 ký tự). Gửi `null` để xóa trắng.
panel_footer	string\|null	tùy chọn	Chữ chân trang của tin nhắn nhúng (tối đa 2048 ký tự). Gửi `null` để xóa trắng.
panel_color	string\|null	tùy chọn	Màu tin nhắn nhúng dạng chuỗi thập lục phân, ví dụ `#5865F2`. Gửi `null` để xóa trắng.
panel_image_url	string\|null	tùy chọn	Hình của tin nhắn nhúng dạng địa chỉ http(s). Gửi `null` để xóa trắng.
panel_thumbnail_url	string\|null	tùy chọn	Hình nhỏ của tin nhắn nhúng dạng địa chỉ http(s). Gửi `null` để xóa trắng.
panel_name	string	tùy chọn	Tên bảng dùng khi đặt tên ticket (tối đa 100 ký tự). Chỉ dành cho bảng đơn.
button_text	string\|null	tùy chọn	Chữ trên nút (tối đa 80 ký tự). Chỉ dành cho bảng đơn.
button_color	string	tùy chọn	Kiểu nút: `primary`, `secondary`, `success` hoặc `danger`. Chỉ dành cho bảng đơn.
button_emoji	string\|null	tùy chọn	Biểu tượng trên nút (unicode hoặc mã biểu tượng riêng). Chỉ dành cho bảng đơn.
disabled	boolean	tùy chọn	Tắt bảng hoặc bật lại. Chỉ dành cho bảng đơn.
bypass_auto_close	boolean	tùy chọn	Để ticket từ bảng này nằm ngoài việc đóng tự động, kể cả khi máy chủ đang bật. Chỉ dành cho bảng đơn.
dropdown_placeholder	string\|null	tùy chọn	Chữ gợi ý của danh sách thả xuống (tối đa 150 ký tự). Chỉ dành cho bảng nhiều nút.

Các thiết lập thuộc phần khung (kênh của bảng, danh mục ticket, vai trò được nhắc, biểu mẫu, đội hỗ trợ) không đổi được qua API; hãy dùng bảng điều khiển cho những thứ đó. Phản hồi có kèm message_refreshed; nếu giá trị là false (hoặc bạn vừa đổi dropdown_placeholder ở bảng nhiều nút), hãy gọi Gửi lại bảng để tin nhắn trên Discord được cập nhật.

Bảng dùng bố cục thành phần sẽ từ chối panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url và panel_thumbnail_url với lỗi 400. Hãy sửa bố cục của những bảng này trong bảng điều khiển.

Ví dụ về yêu cầu

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>

Ví dụ về phản hồi

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