दस्तावेज़

TicketsX जल्दी सीखें

सेटअप की गाइड, सारी कमांड, Premium की सुविधाएँ और REST API, सब एक जगह।

13.11

पैनल बदलना

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

पैनल की सेटिंग बदलता है: नाम, एम्बेड संदेश, रंग, बटन की सूरत, और यह कि पैनल अपने आप बंद होने से छूट लेता है या नहीं। Discord में मौजूद पैनल संदेश अपने आप ताज़ा हो जाता है। इसके लिए `manage_panels` अनुमति चाहिए (शुरू में बंद रहती है)।

अनुरोध की सामग्री (सारे फ़ील्ड वैकल्पिक हैं; सिर्फ़ वही भेजें जो बदलना है)

नामप्रकारज़रूरीविवरण
panel_titlestring|null
वैकल्पिक
एम्बेड का शीर्षक (ज़्यादा से ज़्यादा 256 अक्षर)। ख़ाली करने के लिए null भेजें।
panel_descriptionstring|null
वैकल्पिक
एम्बेड का विवरण (ज़्यादा से ज़्यादा 4096 अक्षर)। ख़ाली करने के लिए null भेजें।
panel_contentstring|null
वैकल्पिक
एम्बेड के ऊपर का सादा पाठ (ज़्यादा से ज़्यादा 2000 अक्षर)। ख़ाली करने के लिए null भेजें।
panel_footerstring|null
वैकल्पिक
एम्बेड के फ़ुटर का पाठ (ज़्यादा से ज़्यादा 2048 अक्षर)। ख़ाली करने के लिए null भेजें।
panel_colorstring|null
वैकल्पिक
एम्बेड का रंग हेक्स स्ट्रिंग में, जैसे #5865F2। ख़ाली करने के लिए null भेजें।
panel_image_urlstring|null
वैकल्पिक
एम्बेड की छवि http(s) पते के रूप में। ख़ाली करने के लिए null भेजें।
panel_thumbnail_urlstring|null
वैकल्पिक
एम्बेड की छोटी छवि http(s) पते के रूप में। ख़ाली करने के लिए null भेजें।
panel_namestring
वैकल्पिक
टिकटों के नाम रखने में इस्तेमाल होने वाला पैनल नाम (ज़्यादा से ज़्यादा 100 अक्षर)। सिर्फ़ एकल पैनलों के लिए।
button_textstring|null
वैकल्पिक
बटन का पाठ (ज़्यादा से ज़्यादा 80 अक्षर)। सिर्फ़ एकल पैनलों के लिए।
button_colorstring
वैकल्पिक
बटन की शैली: primary, secondary, success या danger। सिर्फ़ एकल पैनलों के लिए।
button_emojistring|null
वैकल्पिक
बटन की इमोजी (यूनिकोड या अपनी इमोजी की आईडी)। सिर्फ़ एकल पैनलों के लिए।
disabledboolean
वैकल्पिक
पैनल को बंद करता है या दोबारा चालू करता है। सिर्फ़ एकल पैनलों के लिए।
bypass_auto_closeboolean
वैकल्पिक
इस पैनल के टिकटों को अपने आप बंद होने से बाहर रखता है, भले ही सर्वर पर यह सुविधा चालू हो। सिर्फ़ एकल पैनलों के लिए।
dropdown_placeholderstring|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"
    }
  }
}