توثيق API والمنصة
كل خدمة خلفية تقدّم واجهة Swagger تفاعلية مباشرة على /docs، وتُولَّد مواصفة OpenAPI موحّدة في docs/api/openapi.yaml بمستودع المنصة.
كل الطلبات تمر عبر بوابة API. المصادقة عبارة عن Bearer JWT (Authorization: Bearer <token>) على كل مسار عدا التسجيل، تسجيل الدخول، استعادة كلمة المرور، وكتالوج الفوترة العام.
الوحدات
/api/v1/auth, /api/v1/usersالتسجيل، تسجيل الدخول، المصادقة الثنائية، إدارة الملف الشخصي وكلمة المرور ذاتياً.
/api/v1/billingالباقات، الدفع، الاشتراكات، الفواتير، ويب هوك.
/api/v1/engagements, /api/v1/scansدورة حياة الفحص، إرسال الفحوصات، النتائج.
/api/v1/assets, /api/v1/findingsسجل الأصول، الفحص المجدول، تقارير الامتثال.
/api/v1/socاستيعاب الأحداث، الربط، التنبيه المعزول لكل مستأجر.
/api/v1/threatsإدارة مؤشرات الاختراق، تنميط بصمة التهديد.
/api/v1/dfirإدارة الحالات، الأدلة، الخط الزمني.
/api/v1/easmالتحقق من النطاق، الاكتشاف، تتبع الانكشاف.
/api/v1/basسيناريوهات محاكاة الهجوم ونتائجها.
/api/v1/mobileفحوصات قائمة تحقق مُعلنة ذاتياً، جلسات المختبر الديناميكي.
/api/v1/chat, /api/v1/copilotالمساعد الذكي وكوبايلوت محلل SOC.