13.11
पैनल बदलना
/<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"
}
}
}