Noxyr अब एक मुफ़्त, प्रति-सर्वर REST API देता है, ताकि आप लाइव Discord डेटा, सदस्य संख्या, टिकट विश्लेषण, गतिविधि के आंकड़े, बिक्री, रिव्यू और giveaways को अपनी वेबसाइट, डैशबोर्ड, मोबाइल ऐप या किसी दूसरे बॉट में ला सकें। हर सर्वर के लिए एक key, जो डैशबोर्ड से बनती है, SHA-256 हैशिंग से सुरक्षित, और आपके नियंत्रित scope टॉगल से सीमित।
सर्वर-स्कोप्ड API क्यों?
ज़्यादातर Discord बॉट या तो कोई डेटा नहीं देते, या आपसे उम्मीद करते हैं कि आप intents, gateway कनेक्शन और rate-limit का हिसाब लगाकर कच्चे Discord API से जूझें। Noxyr Server API इसके उलट है: एक header भेजें, JSON पाएं। छह endpoints वे सवाल कवर करते हैं जो सर्वर मालिक असल में पूछते हैं: कितने सदस्य हैं, इस हफ़्ते कितने टिकट आए, हर मुद्रा में कितनी आय है, औसत रिव्यू रेटिंग कितनी है, कौन-से giveaways चल रहे हैं, दैनिक गतिविधि का रुझान क्या है।
आज आप क्या पढ़ सकते हैं
GET /api/v1/server: सर्वर का नाम, आइकन URL, लाइव सदस्य संख्या, ऑनलाइन संख्या, boosts, बनने की तारीख।GET /api/v1/tickets: कुल / खुले / बंद टिकट, पिछले 7 और 30 दिनों में खुले टिकट, पिछले 7 दिनों में बंद टिकट, औसत रेटिंग और रेटिंग संख्या।GET /api/v1/activity?days=30: 90 दिनों तक के दैनिक संदेश, joins और leaves, शून्य से भरे हुए ताकि हर तारीख मौजूद रहे।GET /api/v1/invoices: इनवॉइस संख्या, 7 / 30 दिनों की मात्रा और हर मुद्रा में आय, साथ में भुगतान स्थिति का विवरण।GET /api/v1/reviews: कुल पोस्ट किए गए रिव्यू, औसत रेटिंग, 1–5 स्टार का विवरण और नवीनतम 5 रिव्यू (प्रोडक्ट, रेटिंग, छोटा टेक्स्ट, लेखक)।GET /api/v1/giveaways: सक्रिय / समाप्त संख्या, कुल एंट्री और अगले समाप्त होने वाले 5 चल रहे giveaways।
सुरक्षा मॉडल
Keys nxr_ से शुरू होती हैं और उनमें 192 bits की entropy होती है। सर्वर पर केवल एक SHA-256 हैश सेव होता है; कच्ची key बनाते समय एक बार दिखाई जाती है और उसे वापस नहीं पाया जा सकता। हर response दो जांचों से गुज़रता है: क्या key चालू है, और क्या इस endpoint का scope चालू है? किसी scope को बंद करने पर तुरंत 403 मिलता है; key को बंद या रद्द करने पर बिना redeploy के सारी पहुँच खत्म हो जाती है। Rate limiting हर key के लिए 60 requests प्रति मिनट है।
शुरू करना (60 सेकंड)
- 1. डैशबोर्ड खोलें, अपना सर्वर चुनें और API Access पर जाएं।
- 2. Generate API Key पर क्लिक करें और मान कॉपी करें; यह केवल एक बार दिखाया जाता है।
- 3. scopes चालू या बंद करें। हर scope का अपना टॉगल है।
- 4.
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"चलाएं, और आप लाइव हैं।
आम इंटीग्रेशन
अपने लैंडिंग पेज पर लाइव सदस्य काउंटर दिखाएं। एक निजी staff चैनल में साप्ताहिक टिकट डाइजेस्ट पोस्ट करें। giveaways में सबसे ज़्यादा भागीदारी वाला सार्वजनिक लीडरबोर्ड बनाएं। बिक्री का डेटा किसी स्प्रेडशीट या अपने एडमिन पैनल से जोड़ें। चूँकि responses सादे JSON हैं और CORS उदार है, आप बिना किसी proxy के सीधे ब्राउज़र से API कॉल कर सकते हैं।
आगे क्या
संबंधित पढ़ाई: Discord API बनाम Noxyr Server API, चरण दर चरण ट्यूटोरियल, इन endpoints के पीछे के डिज़ाइन सिद्धांत और हम Discord API की गलतियों को कैसे संभालते हैं।