13.15
टिकट का पैनल बदलना
POST
/<guild_id>/api/tickets/<ticket_id>/switch-panelटिकट को किसी दूसरे एकल पैनल में ले जाता है। यह /switchpanel कमांड का API रूप है। टिकट का नाम नए पैनल के ढाँचे के हिसाब से बदल जाता है, चैनल वाले टिकटों में वह उसकी श्रेणी में चला जाता है, और नए पैनल की सहायता टीमों को पहुँच मिल जाती है। इसके लिए `switch_panel` अनुमति चाहिए (शुरू में बंद रहती है)।
अनुरोध की सामग्री
| नाम | प्रकार | ज़रूरी | विवरण |
|---|---|---|---|
| panel_id | number | ज़रूरी | उस एकल पैनल की आईडी जिसमें टिकट ले जाना है (पैनलों की सूची देखें)। |
| keep_permissions | boolean | वैकल्पिक | चैनल पर मौजूदा भूमिका अनुमतियाँ नए पैनल की टीमों के साथ-साथ बनी रहने दें (तयशुदा true)। सिर्फ़ नए पैनल की सहायता टीमों को पहुँच देनी हो तो false रखें। |
टिकट का तरीक़ा मिलना चाहिए: चैनल वाले टिकट सिर्फ़ चैनल आधारित पैनलों में और थ्रेड वाले टिकट सिर्फ़ थ्रेड आधारित पैनलों में जा सकते हैं। चूँकि बदलने पर चैनल का नाम भी बदलता है, Discord इसे 10 मिनट में क़रीब दो बार ही होने देता है; यह एंडपॉइंट भी वही सीमा मानता है और सीमा पार होने पर retry_after के साथ 429 लौटाता है।
अनुरोध का उदाहरण
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"panel_id":2,"keep_permissions":true}' \
https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panelजवाब का उदाहरण
{
"message": "Panel switched to `Billing` successfully.",
"ticket_id": 42,
"panel_id": 2,
"keep_permissions": true
}