واجهة برمجية مفتوحة ضمن النظام

حديث الربط مع معظم موردي أنظمة ERP يسير على نص معروف. نعم نربط. نعم هناك واجهة برمجية. ثم يظهر رقم، لكل ربط، وكل سنة، فيتحول المشروع الذي ظننته أسبوعاً إلى دورة شراء كاملة.

ونما يقف الموقف الآخر. واجهة ERP البرمجية جزء من النظام: عمليات إنشاء وقراءة وتعديل وحذف على كل الكيانات، منشورة بمواصفة OpenAPI 3.0، وهي — بنص التوثيق — متاحة لكل عميل بلا تكلفة إضافية.

متصفح واجهات مولَّد من نظامك أنت

وجّه المتصفح إلى متصفح الواجهات فتحصل على الفهرس الحيّ: كل كيان متاح لك، بمسماه العربي والإنجليزي، مصفّى بصلاحيات الوحدات وحقوق وصولك والخصائص المفعّلة فعلاً في تركيبك. وليس ملف PDF ثابتاً كُتب سنة ٢٠١٩.

ولكل كيان أمران يحتاجهما المبرمج:

• مواصفة OpenAPI بصيغة JSON تقرؤها الأدوات الحديثة فتولّد منها عميلاً مباشرة،
• وصفحة Swagger تفاعلية لاستكشاف النداءات وتجريبها قبل كتابة سطر واحد.

وإلى جانب واجهات الكيانات نقاط نهاية لأغراض خاصة، لأعمال ليست إنشاءً وقراءةً عادية — كمزامنة أجهزة الحضور والانصراف مثلاً.

توثيقها بشخص لا ببرنامج

تستخدم الواجهة سجل بيانات اعتماد API يربط مفتاحاً وسراً بحساب مستخدم حقيقي. فكل ما يفعله المنادي يفعله بصفة ذلك المستخدم: صلاحيات مستوى السجل تُطبَّق، والأبعاد تُطبَّق، والتحقق يُطبَّق، والمستند المرحَّل يولّد قيوده وحركاته المخزنية تماماً كما لو أُدخل من شاشة.

والنتيجة تستحق أن تُقال: لا يمكن أن يكتسب الربط سلطة أكبر من سلطة الشخص الذي يمثّله، وإلغاؤه تعطيلُ سجل واحد. وهي الآلية نفسها التي يقوم عليها خادم MCP، وليست مصادفة — باب واحد وزوّار من أنواع شتى.

من أين تأتي التكلفة فعلاً

الصراحة هنا أنفع من الشعارات. فاتجاهات تدفق البيانات أربعة، وليست متساوية الكلفة:

• النظام الآخر يقرأ من نما أو يكتب فيه. كلاهما يعمل عبر الواجهة القياسية بلا تطوير من جانبنا وبلا تكلفة إضافية.
• نما يقرأ من النظام الآخر أو يكتب فيه. هنا العمل حقيقي، وكلفته تتوقف تقريباً كلياً على توثيق الطرف الآخر. فنظام له مواصفة واضحة وبيئة تجريبية قد يستغرق أياماً، ونظام قديم بلا توثيق قد يستغرق أسابيع أو شهوراً.
• نقطة نهاية مخصصة — تجميع حقول غير قياسي، أو استجابة واحدة تدمج عدة كيانات — عمل تطويري يُسعَّر كذلك.

فالسؤال الذي يُطرح قبل أن يسعّر أحد شيئاً ليس عن نما، بل: هل للنظام الآخر واجهات موثّقة، وهل يمكننا الاطلاع عليها؟

وحيث لا تحتاج الواجهة أصلاً

تغطي الروابط الجاهزة المسارات التي تسلكها معظم المنشآت أولاً — منصات التجارة الإلكترونية والأسواق، وأجهزة البصمة، وبوابات الدفع. والواجهة البرمجية هي ما يجعل ما تبقّى قراراً لك لا عرض سعر.