การแก้ไขแผง

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` ส่ง `null` เพื่อล้างค่า
panel_image_url	string\|null	ไม่บังคับ	รูปภาพของข้อความฝังเป็นที่อยู่ http(s) ส่ง `null` เพื่อล้างค่า
panel_thumbnail_url	string\|null	ไม่บังคับ	รูปย่อของข้อความฝังเป็นที่อยู่ http(s) ส่ง `null` เพื่อล้างค่า
panel_name	string	ไม่บังคับ	ชื่อแผงที่ใช้ตอนตั้งชื่อทิกเก็ต (ไม่เกิน 100 อักขระ) ใช้ได้กับแผงเดี่ยวเท่านั้น
button_text	string\|null	ไม่บังคับ	ข้อความบนปุ่ม (ไม่เกิน 80 อักขระ) ใช้ได้กับแผงเดี่ยวเท่านั้น
button_color	string	ไม่บังคับ	รูปแบบปุ่ม `primary`, `secondary`, `success` หรือ `danger` ใช้ได้กับแผงเดี่ยวเท่านั้น
button_emoji	string\|null	ไม่บังคับ	อีโมจิบนปุ่ม (ยูนิโคดหรือรหัสอีโมจิที่กำหนดเอง) ใช้ได้กับแผงเดี่ยวเท่านั้น
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"
    }
  }
}