يبدأ حديث الربط مع كثير من موردي أنظمة ERP بتأكيد وجود واجهة برمجية، ثم تظهر تكلفة مستقلة لكل ربط وربما لكل سنة، فيتحول العمل التقني المحدود إلى دورة شراء جديدة.
أما في نما فـواجهة ERP البرمجية جزء من النظام: عمليات إنشاء وقراءة وتعديل وحذف على كل الكيانات، منشورة بمواصفة OpenAPI 3.0، وهي بنصّ التوثيق متاحة لكل عميل بلا تكلفة إضافية.
متصفح واجهات مولَّد من نظامك أنت
افتح متصفح الواجهات تجد الفهرس الحيّ: كل كيان متاح لك، بمسماه العربي والإنجليزي، مصفّى بصلاحيات الوحدات وحقوق وصولك والخصائص المفعّلة فعلاً في تركيبك. وليس ملف PDF ثابتاً كُتب سنة ٢٠١٩.
ولكل كيان أمران يحتاجهما المبرمج:
- مواصفة OpenAPI بصيغة JSON تقرؤها الأدوات الحديثة فتولّد منها عميلاً مباشرة،
- وصفحة Swagger تفاعلية لاستكشاف النداءات وتجريبها قبل كتابة سطر واحد.
وإلى جانب واجهات الكيانات نقاط نهاية لأغراض خاصة، لأعمال ليست إنشاءً وقراءةً عادية — كمزامنة أجهزة الحضور والانصراف مثلاً.
توثيقها بشخص لا ببرنامج
تستخدم الواجهة سجل بيانات اعتماد API يربط مفتاحاً وسراً بحساب مستخدم حقيقي. فكل ما يفعله المنادي يفعله بصفة ذلك المستخدم: صلاحيات مستوى السجل تُطبَّق، والمحددات تُطبَّق، والتحقق يُطبَّق، والمستند المرحَّل يولّد قيوده وحركاته المخزنية تماماً كما لو أُدخل من شاشة.
والنتيجة تستحق أن تُقال: لا يمكن أن يكتسب الربط سلطة أكبر من سلطة الشخص الذي يمثّله، وإلغاؤه تعطيلُ سجل واحد. وهي الآلية نفسها التي يقوم عليها خادم MCP، وليست مصادفة — باب واحد وزوّار من أنواع شتى.
من أين تأتي التكلفة فعلاً
الصراحة هنا أنفع من الشعارات. فاتجاهات تدفق البيانات أربعة، وليست متساوية الكلفة:
- النظام الآخر يقرأ من نما أو يكتب فيه. كلاهما يعمل عبر الواجهة القياسية بلا تطوير من جانبنا وبلا تكلفة إضافية.
- نما يقرأ من النظام الآخر أو يكتب فيه. هنا العمل حقيقي، وكلفته تتوقف تقريباً كلياً على توثيق الطرف الآخر. فنظام له مواصفة واضحة وبيئة تجريبية قد يستغرق أياماً، ونظام قديم بلا توثيق قد يستغرق أسابيع أو شهوراً.
- نقطة نهاية مخصصة. تجميع حقول غير قياسي، أو استجابة واحدة تدمج عدة كيانات، وهو عمل تطويري يُسعَّر كذلك.
فالسؤال الذي يُطرح قبل أن يسعّر أحد شيئاً ليس عن نما، بل: هل للنظام الآخر واجهات موثّقة، وهل يمكننا الاطلاع عليها؟
الروابط الجاهزة قبل الواجهة البرمجية
تغطي الروابط الجاهزة المسارات التي تسلكها معظم المنشآت أولاً — منصات التجارة الإلكترونية والأسواق، وأجهزة البصمة، وبوابات الدفع. والواجهة البرمجية هي ما يجعل ما تبقّى قراراً لك لا عرض سعر.
إجابات مباشرة عن أسئلتك
أي الكيانات تغطيها الواجهة؟
كلها. يعرض متصفح الواجهات كل كيان متاح للمستخدم الحالي مصفّى بصلاحيات الوحدات وحقوق الوصول والخصائص المفعّلة، ويقدّم لكل كيان مواصفة OpenAPI قابلة للقراءة آلياً وصفحة Swagger تفاعلية.
هل استخدام الواجهة يكلّف إضافياً؟
لا. يقول التوثيق ذلك صراحة: الواجهة القياسية، لكل الكيانات وكل العمليات، متاحة لكل عميل بلا تكلفة إضافية وبلا تطوير من جانبنا. والمدفوع هو العمل المخصص — شكل بيانات غير قياسي، أو نقطة نهاية مركّبة تدمج عدة كيانات في استجابة واحدة.
كيف تُوثَّق الواجهة، وبصلاحيات من تعمل؟
بسجل بيانات اعتماد API يربط مفتاحاً وسراً بمستخدم حقيقي. فكل ما يفعله المنادي يفعله بصفة ذلك المستخدم، وتُطبَّق صلاحيات مستوى السجل والمحددات وقواعد التحقق كما تُطبَّق على الشاشات.
وإن لم يكن للنظام الآخر واجهة برمجية؟
فالتكلفة على ذلك الجانب لا على جانبنا، والتقدير يتوقف كلياً على توثيقه. فنظام له مواصفة واضحة وبيئة تجريبية قد يستغرق أياماً، ونظام قديم بلا توثيق قد يستغرق شهوراً. اطلب توثيق الطرف الآخر قبل أن يسعّر أحد شيئاً.
هل توجد روابط جاهزة؟
نعم — منصات التجارة الإلكترونية والأسواق، وأجهزة البصمة، وبوابات الدفع من بينها. والواجهة البرمجية هي ما يغطي ما سواها.
