Discord API الرسمية واجهة منخفضة المستوى مصممة للبوتات والعملاء؛ تتعامل مع أحداث الـ gateway، وتخزن البيانات مؤقتاً يدوياً، وتدير الـ intents بنفسك. أما Noxyr Server API فهي واجهة HTTP عالية المستوى محصورة في خادم واحد، وتعيد تحليلات جاهزة. كل منهما يحل مشكلة مختلفة. إليك متى تلجأ إلى كل واحدة.

Discord's gateway events and the Noxyr Server API's simple GET request both feed into your app. Discord API Gateway Noxyr API GET /v1 JSON Your app react to events read live stats

ما الذي تمنحك إياه Discord API

توثيق Discord API (وهو من أكثر ما يُبحث عنه، إذ يُظهر Google Trends ارتفاع الاستعلامات عن "discord api documentation" بنسبة 700% على أساس سنوي) هو المرجع الأساسي لكل ما تملكه ديسكورد نفسها: الرسائل، والمستخدمون، والخوادم (guilds)، والرتب، والقنوات، والصوت، والخيوط، والإشراف. تحصل على REST API للإجراءات، وعلى WebSocket gateway للأحداث. وبناء أي شيء في الوقت الفعلي يتطلب فتح اتصال دائم، والتعامل مع READY ونبضات القلب (heartbeats)، وإبطال التخزين المؤقت، ومجموعات حدود المعدل.

ما الذي تمنحك إياه Noxyr Server API

واجهة Noxyr Server API أصغر بكثير: ست نقاط نهاية للقراءة فقط، محصورة في خادم واحد عبر رمز bearer. تجيب عن أسئلة مثل "كم عدد التذاكر هذا الشهر؟" أو "الإيرادات لكل عملة" التي لا تستطيع Discord API الإجابة عنها إطلاقاً، لأن البيانات الأساسية موجودة في قاعدة بيانات Noxyr، لا في ديسكورد.

مقارنة جنباً إلى جنب

  • المصادقة: ديسكورد تستخدم OAuth2 أو رموز البوت مع الـ intents. Noxyr تستخدم رمز bearer واحداً لكل خادم.
  • النقل: ديسكورد هي REST + WebSocket gateway. Noxyr هي HTTPS عادية مع تفعيل CORS للمتصفحات.
  • النطاق: ديسكورد عامة لبوتك عبر كل خادم يوجد فيه. Noxyr مقيدة بخادم محدد واحد.
  • شكل البيانات: ديسكورد تعيد كائنات خام: خوادم، وأعضاء، ورسائل. Noxyr تعيد تجميعات، ومجاميع، ومتوسطات، وأعداداً يومية.
  • حدود المعدل: ديسكورد تستخدم حدوداً مجمّعة لكل مسار. Noxyr حد ثابت 60 طلباً في الدقيقة لكل مفتاح.
  • جهد الإعداد: ديسكورد تحتاج إلى تطبيق بوت، ودعوة، وintents، ومعالجات أحداث. Noxyr تحتاج إلى نقرة واحدة لإنشاء المفتاح.

اختر Discord عندما…

  • تحتاج إلى أحداث في الوقت الفعلي (وصلت رسالة، أو انضم عضو، أو تغيرت قناة صوتية).
  • تريد إرسال الرسائل، أو تعديل القنوات، أو حظر المستخدمين، أو إدارة الرتب من تطبيقك.
  • تبني بوت ديسكورد أو عميل ديسكورد من طرف ثالث.

اختر Noxyr Server API عندما…

  • تريد عرض إحصائيات الخادم المباشرة على موقع عام دون الحفاظ على بوت.
  • تحتاج إلى تحليلات التذاكر، أو بيانات المبيعات، أو متوسطات التقييمات، أو مشاركة الهدايا، وهي بيانات لا تخزنها ديسكورد.
  • تريد JSON متوافقاً مع CORS يمكنك استدعاؤه من لوحة تحكم في المتصفح دون وسيط (proxy).
  • تريد واجهة مستقرة ومُصدَّرة بإصدارات، حيث تتيح مفاتيح النطاق إيقاف كشف البيانات دون إعادة نشر أي شيء.

استخدام الاثنين معاً

الواجهتان تتكاملان جيداً. استخدم Discord API في بوتك الخاص للتفاعل مع الأحداث، واستخدم Noxyr Server API لقراءة الحالة المجمعة على موقعك. بهذه الطريقة لا تحتاج لوحة التحكم العامة لديك إلى intents البوت أو اتصالات الـ gateway على الإطلاق، بل يكفي طلب HTTPS واحد.

للمزيد: درس Server API، ومبادئ التصميم، والتعامل مع أخطاء Discord API.