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