تخطّي إلى المحتوى
تصفّح التوثيق

الإدارة والتكاملات

تخطيط تكامل موقع أو نظام شريك

حدّد البيانات والصلاحيات والتحقق المطلوب للربط قبل إطلاق موقع أو بوابة أو نظام شريك.

2 دقائق للقراءة·تمت المراجعة

في هذه الصفحة

يربط التكامل نظامين تشغيليين لكل منهما مسؤولياته. تتضمن REX-OPS مسارات API وخلاصات بيانات للمخزون والشركاء، إلى جانب استقبال العملاء المحتملين. ابدأ بالنتيجة وحدود البيانات قبل اختيار الأسلوب التقني.

تحديد تبادل البيانات

دوّن ما يحتاج النظام المستقبِل إلى قراءته أو إرساله. من الأمثلة الشائعة نشر مخزون مختار على موقع، أو توزيع إعلانات على بوابة، أو توجيه استفسار إلى مسار المبيعات.

  • حدّد المصدر المعتمد لكل حقل.
  • حدّد المشاريع أو الوحدات أو السجلات المشمولة في النطاق.
  • اتفق على كيفية التعامل مع تغييرات التوافر والأسعار.
  • حدّد من يراقب الأعطال ومن يمكنه تغيير الربط.

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

الحصول على المواصفة التقنية الحالية

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

يشرح هذا الدليل تخطيط التكامل. وهو يتعمد عدم نشر أمثلة للطلبات أو تفاصيل نقاط النهاية التي قد تختلف عن المواصفة الصادرة لمساحة عملك.

الاستعداد للأعطال المعتادة

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

استخدم آليات منع التكرار وحالة التسليم وإعادة المحاولة المحددة في مواصفة التكامل الفعلية. تجنّب إرسال العميل المحتمل أو المعاملة نفسها مرارًا دون وسيلة لتحديد ما إذا كانت قد قُبلت بالفعل.

التحقق من المسار كاملًا

  1. استخدم بيئة الاختبار المعتمدة وبيانات ممثلة غير حساسة.
  2. افحص سجل المصدر ونطاق النشر المقصود.
  3. افحص ما يعرضه النظام المستقبِل أو يخزّنه فعليًا.
  4. غيّر حقلًا ذا صلة وتحقق من كيفية وصول التحديث.
  5. اختبر حالة فشل، وتأكد من قدرة الفريق المسؤول على تحديدها.

بالنسبة لاستقبال العملاء المحتملين، فإن القبول عند نقطة نهاية HTTP ليس سوى نقطة تحقق واحدة. أكّد وصول الاستفسار إلى مساحة العمل المقصودة مع الحفاظ على بيانات اتصاله ومصدره والمسؤول عنه أو مسار توجيهه.

تخطيط التشغيل والتغيير

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

راجع API والتكاملات، والمخزون، وتواصل مع الفريق لإجراء تقييم تقني.