محور المكامل

الهدف

ربط الأنظمة الخارجية بـ BlueMatrix عبر واجهة البرمجة العامة v1 (قراءة فقط) وعقد OpenAPI.

لمن

الشركاء والمكاملون. شاشة التكاملات للموظفين تدير الويب هوكات/الاتصالات — وليست شاشة إنشاء رموز واجهة البرمجة العامة. الرموز هي Sanctum مع tenant:{uuid} وapi:*.

المتطلبات

• مستخدم يمكنه إنشاء رموز في بيئتك.
• معرفة القدرات المطلوبة.
• لقراءات CRM: وحدة crm مفعّلة.

ابدأ من هنا

1. واجهة البرمجة العامة v1
2. مواصفة OpenAPI
3. المرجع السردي
4. المتاجر المخصصة وواجهات Headless — حزمة Commerce للوكالات

الخطوات

1. أنشئ رمزاً يتضمن tenant:{uuid} وقدرات api:*.
2. استدعِ GET /api/v1/meta للتحقق.
3. اقرأ القوائم/التفاصيل مع الصفحات وحد 120 طلب/دقيقة.
4. عبر المنشآت ← 404؛ قدرة ناقصة ← 403؛ CRM معطّل ← 422.

النتيجة

تزامن نماذج القراءة دون واجهة الموظفين.

التوقفات

لا كتابة في v1؛ مسارات POS/البوابة/الموظفين خارج نطاق التكامل العام.

ذات صلة

• تطوير
• نموذج الصلاحيات