المدوّنة · 7 سبتمبر 2023 · Steve Simpson · التكامل

تانغو Salesforce: فهم رقصة API بين العميل والخادم.

مقدمة

إليك أفكارًا حول فهم التفاعلات بين العميل والخادم عند إجراء استدعاءات API في Salesforce، وهو جانب حاسم في سلسلة التكامل على stevetecharc.com.

تانغو Salesforce: رقصة التفاعل

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

مخطط: ما يتولاه كلٌّ من العميل والخادم في استدعاء API: الموقع، وOAuth، والبروتوكول، والعقد، والحمولة، والتتبع وتصحيح الأخطاء، والأخطاء

مسؤوليات جهة الخادم

سواء كانت Salesforce أو كيان خارجي هو الخادم، تبقى المسؤوليات نفسها. يجب أن يكون الخادم قابلًا للوصول، وأن تكون لديه عملية استماع (listener) على منفذ محدد (عادةً 443 لـ SSL)، وربما خادم مصادقة إذا استُخدم OAuth. يحدد الخادم البروتوكول، ويقدّم الملفات اللازمة للعميل، ويقرر شكل الحمولة، ويمكنه تتبع الحمولة الواردة والأداء في المعالجة الداخلية.

مسؤوليات جهة العميل

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

Salesforce بوصفها خادمًا

مخطط: واجهات Salesforce API التي يمكن لعميل خارجي استدعاؤها (SOAP وREST وBulk وApex SOAP وREST وMetadata وTooling وStreaming وPub/Sub) بعد المصادقة عبر تطبيق متصل ومستخدم تكامل

عندما تعمل Salesforce بوصفها الخادم، قد تتطلب تطبيقًا متصلًا وملف تعريف للتكامل ومستخدم تكامل لإعداد OAuth. ويمكن أن يكون العملاء كيانات خارجية متنوعة تستدعي Salesforce، مستخدمة واجهات API وبروتوكولات مختلفة حسب الحاجة.

Salesforce بوصفها عميلًا

مخطط: Salesforce بوصفها عميلًا يستدعي خوادم خارجية: موصلات إلى Marketing Cloud وAccount Engagement وB2C Commerce، واستدعاءات Apex SOAP وREST الصادرة، وExternal Services، والرسائل الصادرة (outbound messages)، وSalesforce Connect مع OData، وHeroku Connect

يمكن لـ Salesforce أيضًا أن تعمل بوصفها عميلًا، فتجري استدعاءات صادرة إلى خوادم خارجية. وقد تتضمن هذه العملية استيراد ملفات WSDL، وتوليد Apex، وإعداد بيانات الاعتماد المسمّاة (named credentials) لخوادم SOAP وREST. وتلزم إعدادات متنوعة لآليات الاتصال الصادر المختلفة، وكلها تتبع بروتوكولات العميل والخادم الموصوفة سابقًا.

الخلاصة

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