المصادقة وعقد API
عنوان الخدمة: https://api.mastercall.ly/api/v1. مستند OpenAPI الحي هو المرجع للمسارات المتاحة.
تسجيل الدخول وتجديد الجلسة
POST /auth/login يصدر رمز الوصول، ويرسل رمز التحديث داخل Cookie آمنة. POST /auth/refresh يدوّر رمز التحديث. POST /auth/logout يلغي الجلسة. لا تضع الأسرار في الروابط أو مستودعات الكود العامة.
الشركة والصلاحية
أرسل Authorization: Bearer للطلبات المحمية. يتحقق الخادم من العضوية والدور وربط النطاق، ولا يقبل اسم قاعدة بيانات أو هوية شركة غير مخولة لمجرد وجودها في الطلب.
عقد الاستجابة
تحتوي استجابة النجاح على data وrequestId. تحمل الأخطاء error.code وerror.message. احفظ requestId عند طلب الدعم دون نسخ كلمة مرور أو رمز جلسة.
الصفحات والحدود
بعض قوائم النواة تستخدم page وlimit حتى 100 عنصر. بعض القراءات تجلب آخر 1000 سجل، بينما تستخدم مؤشرات الإدارة count حيث يدعمه المخزن. راجع عقد كل مسار بدل افتراض تغطية غير محدودة.
الاختبارات الآمنة
اختبر إنشاء الشركات وتغيير الرخص والدفع في بيئة معزولة. لا تستخدم بيانات عملاء حقيقيين أو مكالمات مدفوعة لاختبار تكامل جديد.
curl 'https://api.mastercall.ly/api/v1/flows' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
# لا تضع رمزًا حقيقيًا في مستودع عام.
# راجع OpenAPI للحقول والأخطاء والصلاحيات.للمساعدة شارك مرجع الطلب أو المكالمة دون كلمات مرور أو أسرار اتصال. لا يثبت حفظ الإعداد نجاح التشغيل قبل الاختبار.