مرجع واجهة برمجة التطبيقات العام

Xponent REST تتيح لك واجهة برمجة التطبيقات (API) قراءة بيانات المتصدرين وبيانات الأعضاء لخادمك من أي تطبيق خارجي.

عنوان URL الأساسي

https://xponentbot.xyz/api/v1

مرر مفتاح واجهة برمجة تطبيقات الخادم الخاص بك في رأس مفتاح x-api. أنشئ مفاتيح من لوحة التحكم → مفاتيح واجهة برمجة التطبيقات.

x-api-key: YOUR_API_KEY

GET /servers/{guild_id}/leaderboard

يعرض أفضل الأعضاء مرتبة حسب XP تنازليًا.

معلمات الاستعلام

مثال للإجابة

{"data":[{"rank":1,"user_id":":"123456", username": "Alice", "level":42,"xp":176400}],"total":1240,"page":1}

GET /servers/{guild_id}/members/{user_id}

يرجع XP والمستوى والرتبة والخط وlast_daily_claim لـ عضو محدد.

مثال للإجابة

{"user_id":"123456"، "اسم المستخدم": "Alice"، "مستوى": 42،xp":176400، "rank":1"،daily_streak":7}

الحصول على /servers/{guild_id}/stats

العوائد إحصائيات الخادم الإجمالية: إجمالي الأعضاء ذوي XP، وإجمالي XP المكتسبة، ومتوسط المستوى، وتكوين المنحنى.

مثال للاستجابة

{"total_members":1240,"total_xp":48200000,"average_level":8,"xp_curve":"standard,"xp_multiplier":1.0}

100 req/hr

الخطة المجانية

1000 req/hr

خطة البداية

10000 طلب/ساعة

الخطة الاحترافية