الانتقال إلى المحتوى
XSIS
تحدث إلى مهندس

التكاملات

تكامل الجهات الخارجية وواجهات API

واجهات API وخدمات الجهات الخارجية مترابطة، مع معالجة حالات الإخفاق

تكاملات REST وSOAP وwebhooks وiPaaS مع أنظمة CRM ومزودي خدمات الشحن والضرائب وKYC والهوية.

نظرة عامة

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

نصمم التكاملات ونبنيها عبر REST وSOAP وGraphQL وwebhooks، إما مباشرة أو من خلال منصة تكامل مثل MuleSoft أو Boomi أو Azure Logic Apps. ونربط الهوية أيضا: تسجيل الدخول الموحد عبر OpenID Connect أو SAML، وتوفير حسابات المستخدمين عبر SCIM، ووصول الخدمات عبر OAuth 2.0.

نصمم كل استدعاء لليوم الذي يخفق فيه الطرف الآخر. نستخدم طلبات متساوية الأثر (idempotent) حتى لا تنشئ إعادة المحاولة سجلا مكررا أبدا، ونعيد المحاولة مع تأخير متزايد عند الأعطال المؤقتة، ونستخدم قائمة الرسائل المتعذرة (dead-letter queue) مع تنبيهات لما يتبقى. ونوثق العقود كتابيا، وندير الإصدارات، ويستطيع فريقك أن يرى ما انتقل وما لم ينتقل.

ما نقدمه

  1. حصر التكاملات

    كل خدمة خارجية تعتمد عليها، والبيانات التي تنتقل منها وإليها، والمسؤول عن كل اتصال.

  2. عقود واجهات API

    تعريفات OpenAPI أو WSDL لكل واجهة، مع قواعد الحقول ورموز الأخطاء والحدود والأمثلة.

  3. الموصلات

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

  4. الهوية وتسجيل الدخول الموحد

    تسجيل الدخول عبر مزود الهوية لديك باستخدام OpenID Connect أو SAML، وتوفير حسابات المستخدمين عبر SCIM حيثما كان مدعوما.

  5. إعادة المحاولة ومنع التكرار والرسائل المتعذرة

    إعادة محاولة آمنة عند الأعطال المؤقتة، وحماية من التكرار في كل عملية كتابة، وقائمة انتظار للرسائل التي يستمر إخفاقها.

  6. سياسة الإصدارات والتغيير

    نظام لإدارة إصدارات واجهات API التي تنشرها، وإجراء لاستيعاب التغييرات في واجهات API التي تستدعيها.

  7. الأسرار وصلاحيات الوصول

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

  8. المراقبة والتنبيهات

    تتبع الطلبات ومعدلات الأخطاء وزمن الاستجابة لكل جهة شريكة، مع تنبيهات تحدد الجهة التي أخفقت وكيف أخفقت.

  9. اختبارات العقود والتكامل

    اختبارات مؤتمتة لكل عقد وفي بيئة الاختبار لدى كل جهة شريكة، تعمل قبل كل إصدار.

طريقة عملنا

  1. 01

    حصر الوضع الحالي

    نحصر الخدمات التي تعتمد عليها، والبيانات التي تحتاج إليها كل خدمة، وحالات الإخفاق التي تواجهها اليوم.

  2. 02

    تصميم العقود

    نكتب عقود واجهات API، ونختار لكل مسار الاستدعاءات المباشرة أو الأحداث أو منصة تكامل.

  3. 03

    بناء الموصلات

    نبني كل موصل ومعه معالجة الأخطاء والحماية من التكرار والتسجيل منذ البداية.

  4. 04

    الاختبار مع كل جهة شريكة

    ننفذ اختبارات العقود وسيناريوهات من البداية إلى النهاية في بيئة الاختبار لدى كل جهة شريكة، بما فيها حالات الإخفاق.

  5. 05

    الإطلاق الآمن

    نطلق خلف مفاتيح تفعيل الميزات (feature flags) أو على مراحل، ونبقي المسار القديم متاحا حتى يثبت المسار الجديد كفاءته.

  6. 06

    التشغيل والتكييف

    نتابع معدلات الأخطاء والرسائل المتعذرة، ونكيف الموصلات عندما تغير الجهات الشريكة واجهات API الخاصة بها.

كيف تترابط الأنظمة

من نظام ERP إلى الجهات الخارجية: منصة واحدة وشركاء كثيرونتخرج أحداث الأعمال من نظام ERP مرة واحدة، وتسلمها منصة التكامل إلى كل شريك بالصيغة التي يتوقعها، وتعود الردود بالطريقة نفسها. والرسالة التي تظل مخفقة بعد المحاولات تنتقل إلى قائمة الرسائل المتعذرة وتطلق تنبيها مرفقا به محتواها.ERPERPالعملاء والطلباتوالفواتيرXSISمنصة التكاملiPaaS أو خدماتمخصصة، والتحويلوإعادة المحاولةجهة خارجيةCRMالحسابات وجهاتالاتصال والفرصالبيعيةجهة خارجيةالخدماتاللوجستية وشركاتالشحنالشحنات والتتبعجهة خارجيةمنصة الفوترةالإلكترونيةوالضرائبالاعتماد والإبلاغجهة خارجيةمزود خدمات KYCوالتحقق من الهويةالتحقق والفحصخدمةقائمة الرسائلالمتعذرةوالتنبيهاتلا يضيع شيءالأشخاصفريق الدعم1REST · ODatawebhook2REST/JSON3REST/JSON4webhook5SOAP/XML · REST6REST/JSON7webhook89

من نظام ERP إلى الجهات الخارجية: منصة واحدة وشركاء كثيرون

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

  • التدفق الرئيسي
  • غير متزامن
  • مسار الاستثناءات

التدفق خطوة بخطوة

  1. من ERP إلى منصة التكامل: أحداث الأعمال، عبر REST · OData · webhook (تدفق رئيسي).
  2. من منصة التكامل إلى CRM: العملاء والطلبات، عبر REST/JSON (تدفق رئيسي).
  3. من منصة التكامل إلى الخدمات اللوجستية وشركات الشحن: حجز الشحنات، عبر REST/JSON (تدفق رئيسي).
  4. من الخدمات اللوجستية وشركات الشحن إلى منصة التكامل: أحداث التتبع، عبر webhook (غير متزامن).
  5. من منصة التكامل إلى منصة الفوترة الإلكترونية والضرائب: فواتير للاعتماد، عبر SOAP/XML · REST (تدفق رئيسي).
  6. من منصة التكامل إلى مزود خدمات KYC والتحقق من الهوية: التحقق من الهوية، عبر REST/JSON (تدفق رئيسي).
  7. من مزود خدمات KYC والتحقق من الهوية إلى منصة التكامل: نتائج التحقق، عبر webhook (غير متزامن).
  8. من منصة التكامل إلى قائمة الرسائل المتعذرة والتنبيهات: رسائل أخفقت بعد إعادة المحاولة، إلى قائمة الرسائل المتعذرة (مسار الاستثناءات).
  9. من قائمة الرسائل المتعذرة والتنبيهات إلى فريق الدعم: تنبيه مع محتوى الرسالة والخطأ (مسار الاستثناءات).

التقنيات

البيانات والتحليلات
  • Apache Kafka
الاختبار
  • Postman
التكامل
  • REST
  • SOAP
  • GraphQL
  • Webhooks
  • OpenAPI
  • MuleSoft
  • Boomi
  • Azure Logic Apps
  • Apache Camel
  • RabbitMQ
إدارة الهوية والوصول
  • OAuth 2.0
  • OpenID Connect
  • SAML 2.0
  • SCIM
  • Keycloak
  • Microsoft Entra ID
معايير الرعاية الصحية
  • HL7 v2
  • HL7 FHIR

طرق التعاون معنا

أسئلة وأجوبة

هل نستخدم منصة تكامل أم شيفرة برمجية مخصصة؟

يعتمد ذلك على عدد الاتصالات لديك ومن سيتولى تشغيلها. فمنصة التكامل مثل MuleSoft أو Boomi أو Azure Logic Apps توفر لك موصلات جاهزة وربطا للحقول ومراقبة في مكان واحد، مقابل تكلفة ترخيص. أما الخدمات المخصصة فتمنحك تحكما كاملا دون ترخيص، لكنك تتولى صيانة شيفرة برمجية أكثر. ونقارن بين الخيارين في حالتك، ونبني على منصة تملكها بالفعل.

رابط هذا السؤال
ماذا يحدث عندما تتعطل واجهة API لدى جهة شريكة؟

تعاد محاولة الطلبات التي تخفق لأسباب مؤقتة مع تأخير متزايد. وتحمل كل عملية كتابة مفتاحا لمنع التكرار (idempotency key)، فلا تنشئ إعادة المحاولة طلبا أو فاتورة ثانية أبدا. وإذا استمر إخفاق رسالة، تنتقل إلى قائمة الرسائل المتعذرة مع محتواها والخطأ، ويصل تنبيه إلى فريقك، ويمكن إعادة إرسالها بعد تعافي الجهة الشريكة.

رابط هذا السؤال
كيف تتعاملون مع تغيير إصدارات واجهات API؟

واجهات API التي تنشرها نمنحها أرقام إصدارات، ونبقي الإصدارات القديمة عاملة لمدة متفق عليها، ونبلغ المستخدمين بما يتغير. أما واجهات API التي تستدعيها، فنتابع إشعارات إيقاف الدعم من كل جهة شريكة، ونختبر الإصدارات الجديدة في بيئتها التجريبية، وننتقل قبل إيقاف الإصدار القديم. وتكشف اختبارات العقود أي تغيير غير معلن قبل أن يصل إلى بيئة الإنتاج.

رابط هذا السؤال
هل يمكنكم ربط مزود الهوية لدينا؟

نعم. نضيف تسجيل الدخول الموحد عبر OpenID Connect أو SAML 2.0 من خلال مزودين مثل Microsoft Entra ID أو Keycloak، ونوفر حسابات المستخدمين تلقائيا عبر SCIM حيث يدعم التطبيق ذلك. وتستدعي الخدمات بعضها بعضا برموز OAuth 2.0 محصورة فيما تحتاج إليه كل خدمة. ويبقى مزود الهوية لديك المكان الوحيد الذي تمنح فيه صلاحيات الوصول وتلغى.

رابط هذا السؤال
كيف تتعاملون مع حدود معدل الطلبات؟

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

رابط هذا السؤال
كم يستغرق تكامل خدمة خارجية؟

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

رابط هذا السؤال
ما الذي يحدد التكلفة؟

عدد الجهات الشريكة والمسارات، وجودة واجهات API لديها، وربط الحقول وقواعد الأعمال، واحتياجات الحجم والتوقيت، وأي تراخيص لمنصات التكامل. ويضيف العمل على الهوية والاعتماد لدى جهة شريكة جهدا إضافيا. ونقدر التكلفة لكل اتصال بعد الحصر، حتى تختار ترتيب التنفيذ وترى تكلفة كل اتصال.

رابط هذا السؤال
من يملك الشيفرة والأعمال التي تنتجونها؟

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

رابط هذا السؤال

أخبرنا بما تحتاج إلى بنائه أو ربطه.

صف لنا الأنظمة والجدول الزمني والقيود، وسيتولى المهندسون المناسبون الأمر من هناك.

  • سيتصل بك فريقنا خلال 24 ساعة في الفترة الزمنية التي تفضلها
  • فريقنا متاح على مدار الساعة طوال أيام الأسبوع