प्रमाणीकरण

API टोकन TicketsX डैशबोर्ड में सर्वर की बग़ल वाली पट्टी से बनाए और सँभाले जाते हैं। हर टोकन एक ही सर्वर से बँधा होता है, और उसे बनाने या इस्तेमाल करने के लिए सर्वर की Premium सदस्यता चालू होनी चाहिए।

टोकन बनाना

सर्वर के लिए Premium को Premium पृष्ठ से चालू करें (API पहुँच पृष्ठ से वहाँ सीधा लिंक है)।
सर्वर की बग़ल वाली पट्टी खोलें और API पहुँच पर जाएँ।
टोकन का नाम रखें (जैसे "सहायता बॉट" या "CRM जोड़")।
टोकन बनाएँ दबाएँ और दिखा हुआ मान कॉपी कर लें।
इसे किसी गुप्त भंडार में रखें; सूचना बंद करने के बाद यह दोबारा नहीं दिखेगा।

अगर Premium ख़त्म हो जाए

आपके टोकन हटाए नहीं जाते। हर API अनुरोध 402 और premium_required: true लौटाने लगता है, और सदस्यता दोबारा चालू होने तक टोकन बनाना या बदलना रुका रहता है। टोकन देखना, बंद करना और रद्द करना फिर भी चलता रहता है, इसलिए सफ़ाई तो आप कर ही सकते हैं। अपने जोड़ में 402 को वैसे ही सँभालें जैसे 401 को: दोबारा कोशिश करना बंद करें और किसी व्यक्ति को बताएँ।

जब सर्वर के पास Premium न हो तब का जवाब

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

टोकन रद्द करते ही वह हर एंडपॉइंट पर तुरंत बेकार हो जाता है। कोई रुकावट न चाहिए तो पहले उसकी जगह लेने वाला टोकन बना लें।

टोकन इस्तेमाल करना

हर अनुरोध के साथ टोकन Bearer हेडर में भेजें। हर अनुरोध सिर्फ़ उसी सर्वर पर लागू होता है जहाँ टोकन बना था।

प्रमाणित अनुरोध का उदाहरण

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  https://api.ticketsx.xyz/<guild_id>/api/tickets