13.2
टिकटों की सूची
GET
/<guild_id>/api/ticketsसर्वर के खुले टिकटों की सूची लाता है। नतीजों को ज़िम्मा लेने की स्थिति, उपयोगकर्ता या टिकट खोलने वाले के हिसाब से सीमित करने वाली वैकल्पिक छन्नियाँ भी चलती हैं।
प्रश्न पैरामीटर
| नाम | प्रकार | ज़रूरी | विवरण |
|---|---|---|---|
| filter | string | वैकल्पिक | टिकटों को स्थिति से छाँटता है। मान्य मान: claimed, mine। |
| user_id | string | वैकल्पिक | वे टिकट छाँटता है जिनमें यह उपयोगकर्ता शामिल है। |
| creator_id | string | वैकल्पिक | इस उपयोगकर्ता आईडी के बनाए टिकट छाँटता है। |
| limit | number | वैकल्पिक | हर पन्ने पर नतीजों की संख्या, 1-100 (तयशुदा 50)। |
| offset | number | वैकल्पिक | पन्ने बाँटने के लिए छोड़े जाने वाले नतीजों की संख्या (तयशुदा 0)। |
जवाबों में pagination वस्तु होती है: { total, limit, offset, returned }। सिर्फ़ खुले टिकट लौटाए जाते हैं।
अनुरोध का उदाहरण
curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
"https://api.ticketsx.xyz/<guild_id>/api/tickets?filter=claimed&creator_id=123456789"