واجهة MasterCall API
عقد REST مُرقّم منذ الإصدار الأول. عنوان الخدمة https://api.mastercall.ly/api/v1.
المصادقة
POST /auth/login يصدر Access JWT صالحًا 15 دقيقة ورمز تحديث داخل Cookie آمنة. POST /auth/refresh يدوّر رمز التحديث. POST /auth/logout يلغي الجلسة.
مساحة العمل
كل طلب يحمل Authorization: Bearer، ويُطابق النطاق مع عضوية المستخدم والشركة المحددة في الجلسة. لا يُقبل اسم قاعدة بيانات من العميل.
عقد الاستجابة
تُعاد النتائج داخل data ومعها requestId. الأخطاء تحمل error.code وerror.message عربية دون تفاصيل البنية الداخلية.
التوثيق الآلي
يتوفر مستند OpenAPI من /api/v1/openapi.json. في نسخة NestJS على الخادم تتوفر Swagger UI من /docs.
حدود الإصدار
قوائم البيانات تُعاد بصفحات حتى 100 عنصر للطلب، وتعتمد المؤشرات الحالية على آخر 1000 سجل. يتطلب الحجم الإنتاجي الكبير استكمال التجميع والفهرسة التشغيلية.
تفعيل خط خارجي أو إضافة موفر يتطلب اعتماد الإعداد واختبار التشغيل؛ إعداد الحقول وحده لا يفعّل الخدمة.