خدمات تكامل الأنظمة عبر API: الأنظمة الأساسية وERP والمنصات الحكومية في السعودية

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

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

روابط ذات صلةصفحة تكامل الأنظمة

تبدأ معظم مشاريع API من نظام ERP: طلبات من متجر إلكتروني، وعملاء من نظام CRM، ومخزون لبوابة العملاء، وقيود للإدارة المالية. فإن كان نظام ERP يوثّق واجهة برمجة بنينا عليها، وإن لم يكن نبني واجهة أمام قاعدة بياناته أو ملفاته أو طابور رسائله، فترى الأنظمة المحيطة به واجهة واضحة ذات إصدارات.

وقاعدتان تمنعان معظم الأعطال. الطلب المرسَل مرتين يجب ألا يُسجَّل مرتين، لذا تحمل كل عملية كتابة مفتاحًا يعرف به المستقبِل أنها مكرّرة. والنظام البطيء يجب ألا يُسقط البوابة معه، لذا يكون لكل طلب حد زمني، وإعادة محاولة محدودة، ورسالة واضحة للمستخدم. ونختبر النص العربي والنصوص المختلطة والترميزات القديمة ببيانات فعلية قبل الإطلاق. وتعرض صفحة تكامل أنظمة ERP الواجهات الشائعة والنمط المناسب لكل منها.

روابط ذات صلةصفحة تكامل أنظمة ERP

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

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

روابط ذات صلةصفحة التكامل مع نفاذدليل المنصات الرقمية السعودية

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

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

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

منظومة التكامل التي لا بوابة لها تكبر قاعدةً بعد قاعدة: كل خدمة تتحقق من المتصلين بطريقتها، وتضع حدودها، وتسجّل بصيغتها. لذا تضع إنتركي Kong Gateway أمام الواجهات. فيُطبَّق التحقق من الهوية (المفاتيح أو JWT أو OAuth 2.0)، وقوائم الوصول، وحدود الطلبات لكل مستهلك، وفحص الطلبات في طبقة واحدة، تُعرَّف في إعدادات محفوظة في نظام إدارة الإصدارات وتُراجَع كما تُراجَع الشيفرة. ويمكن تشغيل البوابة بإدارة ذاتية على بنية تحتية تشغّلونها داخل المملكة، فتبقى الرسائل التي تفحصها هناك. ويشرح قسم إدارة واجهات البرمجة السياسة التي تقف خلفها، وتقارن صفحة بوابة API طرق نشر Kong.

روابط ذات صلةقسم إدارة واجهات البرمجةصفحة بوابة APIصفحة المراقبة الاصطناعية في Datadog

لا تنشر إنتركي سعرًا ثابتًا لخدمات التكامل عبر API، لأن الجهد يتوقف على ما يكشفه الجرد:

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

روابط ذات صلةخدمات مُدارة