Power Bot
Power Bot
الرئيسية المميزات الأوامر التوثيق لوحة التحكم

واجهة API 🔌

نقاط النهاية المتاحة في سيرفر الويب — ابنِ عليها أدواتك الخاصة

الأساس: كل المسارات نسبية لرابط موقعك (مثلاً http://localhost:3000). النقاط الموسومة بـ 🔒 يتطلب دخول تحتاج جلسة تسجيل دخول ديسكورد بالمتصفح (كوكي) وصلاحية إدارة السيرفر المستهدف — والعامة تعمل مباشرة.

🌐 نقاط عامة

GET /api/status عام

حالة البوت الحية: الاتصال، البنق، مدة التشغيل، الذاكرة والإحصائيات العامة. تستخدمها صفحة الحالة.

{
  "online": true,
  "ping": 42,
  "uptime": 86400000,
  "memoryMB": 85.3,
  "servers": 12,
  "users": 4820,
  "commandsUsed": 15304,
  "node": "v22.0.0"
}
GET /api/stats عام

إحصائيات مختصرة للصفحة الرئيسية: عدد السيرفرات والمستخدمين والأوامر المنفذة وحالة الاتصال.

GET /api/public/commands عام

قائمة كل الأوامر (الاسم، الوصف، القسم، طريقة الاستخدام، الاختصارات). تستخدمها صفحة الأوامر.

[
  { "name": "ban", "category": "moderation", "usage": "ban @عضو [السبب]", ... }
]
GET /api/public/leaderboard/:guildId عام

توب 25 بالمستويات لسيرفر معين مع اسم السيرفر وأيقونته — تستخدمها صفحة الليدربورد العامة القابلة للمشاركة.

🔒 نقاط الداشبورد (تتطلب دخول + صلاحية إدارة السيرفر)

GET /api/me · /api/guilds 🔒 يتطلب دخول

/api/me هوية المستخدم الحالي. /api/guilds سيرفراته التي يملك إدارتها مع حالة وجود البوت فيها.

GET /api/guilds/:id/meta · /settings · /commands 🔒 يتطلب دخول

meta: معلومات السيرفر ورومـاته ورتبه. settings: كل إعدادات البوت للسيرفر. commands: الأوامر مع حالة تفعيلها.

POST /api/guilds/:id/settings 🔒 يتطلب دخول

حفظ الإعدادات — يقبل الحقول المعروفة فقط (prefix, welcome, protection, leveling, economy...) ويتجاهل أي حقل غريب، ويسجل التغيير في سجل التغييرات تلقائياً.

POST /api/guilds/123/settings
Content-Type: application/json

{ "prefix": "!", "welcome": { "enabled": true, ... } }
GET /api/guilds/:id/overview-stats?days=7 🔒 يتطلب دخول

سلاسل يومية للرسوم البيانية (رسائل/انضمام/مغادرة) حتى 30 يوماً + أرقام اليوم وإجمالي الأعضاء.

POST /api/guilds/:id/embed · /welcome-test · /welcome-bg 🔒 يتطلب دخول

embed: إرسال إمبيد مخصص لروم. welcome-test: إرسال ترحيب تجريبي عليك. welcome-bg: رفع خلفية ترحيب (JSON فيه data كـ dataURL — png/jpg/webp حتى 6MB).

GET /api/guilds/:id/leaderboard · /audit 🔒 يتطلب دخول

leaderboard: توب المستويات والتقييمات بالأسماء والصور. audit: آخر 50 تغييراً بالإعدادات (من، ماذا، متى).

💡 ملاحظة أمان: كل نقاط الداشبورد محمية بطبقتين — جلسة الدخول + التحقق أن المستخدم يملك صلاحية إدارة السيرفر المطلوب فعلياً من ديسكورد.