أطلق Noxyr الآن واجهة REST مجانية لكل خادم، لتسحب بيانات Discord الحية: أعداد الأعضاء، وتحليلات التذاكر، ومقاييس النشاط، والمبيعات، والمراجعات، والمسابقات، إلى موقعك أو لوحة التحكم أو تطبيقك على الجوال أو بوت آخر. مفتاح واحد لكل خادم، يُنشأ من لوحة التحكم، ويُحمى بتجزئة SHA-256، ويخضع لمفاتيح نطاق تتحكم فيها أنت.

An authenticated API request reaches the Noxyr server and returns JSON with a depleting rate limit. GET /api/v1/server Authorization: Bearer •••••• Noxyr API { "id": "48213" "prefix": "!" "premium": true } RateLimit 60 33 60

لماذا واجهة برمجية محصورة بالخادم؟

معظم بوتات Discord إما لا تكشف أي بيانات، أو تتوقع منك أن تكافح واجهة Discord البرمجية الخام بالنوايا واتصالات البوابة وحسابات تحديد المعدل. واجهة Noxyr البرمجية للخادم عكس ذلك تماماً: أرسل ترويسة، واحصل على JSON. ست نقاط نهاية تغطي الأسئلة التي يطرحها مالكو الخوادم فعلاً: كم عدد الأعضاء، وكم تذكرة هذا الأسبوع، وكم الإيرادات لكل عملة، وما متوسط تقييم المراجعات، والمسابقات الجارية، واتجاه النشاط اليومي.

ما الذي يمكنك قراءته اليوم

  • GET /api/v1/server: اسم الخادم، ورابط الأيقونة، وعدد الأعضاء الحي، وعدد المتصلين، والتعزيزات، وتاريخ الإنشاء.
  • GET /api/v1/tickets: الإجمالي / المفتوحة / المغلقة، والتذاكر المفتوحة خلال آخر 7 و30 يوماً، والمغلقة خلال آخر 7 أيام، ومتوسط التقييم وعدد التقييمات.
  • GET /api/v1/activity?days=30: الرسائل اليومية والانضمامات والمغادرات لمدة تصل إلى 90 يوماً، مع ملء الأيام الفارغة بالصفر حتى يظهر كل تاريخ.
  • GET /api/v1/invoices: عدد الفواتير، وحجم وإيرادات آخر 7 و30 يوماً لكل عملة، إضافة إلى تفصيل حالات الدفع.
  • GET /api/v1/reviews: إجمالي المراجعات المنشورة، ومتوسط التقييم، وتفصيل النجوم من 1 إلى 5، وآخر 5 مراجعات (المنتج، والتقييم، ونص قصير، والكاتب).
  • GET /api/v1/giveaways: عدد المسابقات الجارية والمنتهية، وإجمالي المشاركات، والمسابقات الجارية الخمس التي ستنتهي أولاً.

نموذج الأمان

تبدأ المفاتيح بـ nxr_ وتحمل 192 بت من العشوائية. يُخزَّن على الخادم فقط تجزئة SHA-256، ويُعرض المفتاح الخام مرة واحدة وقت الإنشاء، ولا يمكن استعادته. كل استجابة تمر عبر فحصين: هل المفتاح مفعّل، وهل نطاق نقطة النهاية هذه مُفعَّل؟ إيقاف نطاق يعيد 403 فوراً؛ وتعطيل مفتاح أو إلغاؤه يوقف كل وصول دون إعادة نشر. تحديد المعدل لكل مفتاح على 60 طلباً في الدقيقة.

البداية (60 ثانية)

  • 1. افتح لوحة التحكم، واختر خادمك، واذهب إلى API Access.
  • 2. انقر Generate API Key وانسخ القيمة؛ هذه هي المرة الوحيدة التي تُعرض فيها.
  • 3. فعّل النطاقات أو عطّلها. لكل نطاق مفتاح خاص به.
  • 4. نفّذ curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY" وستكون جاهزاً.

تكاملات شائعة

اعرض عداداً حياً لأعضاء الخادم في صفحتك الرئيسية. انشر ملخصاً أسبوعياً للتذاكر في قناة طاقم خاصة. ابنِ لوحة صدارة عامة لأكثر المشاركين في المسابقات. اربط بيانات المبيعات بجدول بيانات أو بلوحة الإدارة الخاصة بك. ولأن الاستجابات JSON عادي مع CORS متساهل، يمكنك استدعاء الواجهة من المتصفح دون أي وكيل وسيط.

ما التالي

قراءات ذات صلة: واجهة Discord البرمجية مقابل واجهة Noxyr البرمجية للخادم، ودرس خطوة بخطوة، ومبادئ التصميم وراء هذه النقاط، وكيف نتعامل مع أخطاء واجهة Discord البرمجية.