ترجمة بالذكاء الاصطناعي. لم يراجعها المجتمع بعد. اقرأ بالإنجليزية

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

عبر واجهات API: ملخص واجهات Salesforce API

مرحبًا بك في حلقة أخرى من سلسلة التكامل. في هذه الحلقة نستكشف عالم واجهات Salesforce API المعقّد، وهي مكوّن أساسي لتكاملات فعّالة.

مقدمة إلى واجهات Salesforce API

التنقل بين واجهات Salesforce API

تقدّم Salesforce عددًا كبيرًا من واجهات API، لكلٍّ منها غرض مختلف ووظائف مختلفة. سيأخذك هذا الدليل في جولة على هذه الواجهات، ليساعدك على فهم كيفية استخدامها بفعالية في مهام التكامل المختلفة.

فهم المصادقة

قبل الخوض في واجهات API، من المهم فهم عملية المصادقة. عندما يصل متصفح إلى Salesforce، فإنه يُصادِق أمام خادم قبل أن يصل إلى المحتوى الخاص. وهذه المصادقة ضرورية، سواء كنت تصل إلى مواقع ويب عامة، أو بوابات التجربة (experience portals)، أو حتى صفحات عامة لوظائف Web-to-Lead وWeb-to-Case.

مخطط: الوصول إلى Salesforce وواجهات API. يُصادِق تطبيق عميل ومتصفح عبر خادم المصادقة، ثم يصلان إلى خدمات ويب ذات إصدارات (واجهات API القياسية)، وخدمات REST وSOAP مخصصة بلا إصدارات، ومواقع عامة، وWeb-to-Lead وEmail-to-Case

خوادم ويب ذات إصدارات وبلا إصدارات

أهمية الإصدارات

تُصدر Salesforce واجهات API تحت أرقام إصدارات محددة، وتحافظ على قدراتها وتوافقها لسنوات إلى أن تُوقَف في النهاية (deprecated).

بوصفك مستهلكًا لها، عليك أن تعرف الإصدار الذي تستخدمه، وأن تكون مستعدًا للترقية إلى إصدارات أحدث (مع الاختبار).

واجهات REST وSOAP API المخصصة

بالنسبة لواجهات REST أو SOAP API المخصصة التي تنشئها، لا توفر Salesforce إدارة الإصدارات. فمسؤوليتك أنت أن تدير هذه الواجهات وتصونها، وأن تتأكد من أنها تعمل كما هو متوقع مع كل تحديث لـ Salesforce.

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

مصادقة العملاء الخارجيين

عندما يصل عملاء خارجيون إلى Salesforce، يجب أن يُصادِقوا عبر تدفقات محددة. وقد يكون هؤلاء العملاء من أنواع شتى، منها عملاء SOAP الذين يستخدمون Enterprise WSDL أو Partner WSDL، وعملاء REST، وعملاء Bulk API، وغيرهم كثير.

استكشاف واجهات API المختلفة

تفخر Salesforce بمجموعة واسعة من واجهات API، كلٌّ منها مصمَّم لمهام ووظائف محددة. من Salesforce Event Bus الجديد إلى واجهات API مصممة لقطاعات مختلفة مثل الرعاية الصحية والتصنيع، هناك واجهة API لكل حاجة تقريبًا.

لقطة شاشة: صفحة Browse APIs على موقع Salesforce Developers، وفيها قائمة ببطاقات واجهات API

https://developer.salesforce.com/docs/apis (opens in a new tab)

الأدوات والموارد

Postman: أفضل صديق للمطوّر

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

لقطة شاشة: طلب في Postman يشغّل استعلام SOQL على Salesforce REST API، مع ترويسة التفويض واستجابة JSON

الاستفادة من الوثائق والمجموعات

التعرّف على الوثائق المتاحة مفتاح لإتقان واجهات Salesforce API. فموارد مثل REST API Developer Guide ومجموعات Postman المختلفة المتاحة على GitHub يمكن أن تسهّل عملية التطوير كثيرًا.

الخلاصة:

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

لا تتردد في الاستكشاف والتجريب والتكامل!

تابعنا

انطلق في رحلتك مع واجهات Salesforce API بثقة! لمزيد من الأفكار والنصائح، تابعنا هنا على www.SteveTechArc.com وعلى قناة @SteveTechArc (opens in a new tab) على YouTube. اشترك وعمّق فهمك لـ Salesforce وكيف يمكنك دمجها مع أنظمة أخرى.

نساعد في تغيير العالم بمشاركة معلومات التكامل مع زملائنا المعماريين ومع من هم في رحلتهم نحو أن يصبحوا معماريين!

نص مكتوب بمساعدة الذكاء الاصطناعي

STA 1.9