Перекладено ШІ. Спільнота ще не перевірила. Читати англійською

Блог · 7 вересня 2023 р. · Steve Simpson · Інтеграція

Танго Salesforce: розуміємо танець API між клієнтом і сервером.

Вступ

Ось думки про розуміння взаємодії між клієнтом і сервером під час викликів API в Salesforce — ключовий аспект нашої серії про інтеграцію на stevetechart.com.

Танго Salesforce: танець взаємодії

У складному танці викликів API важливо розуміти рухи. Діаграма, яку я зараз розберу, ілюструє танцювальні рухи, тобто взаємодії між клієнтом і сервером.

Діаграма: за що відповідає клієнт, а за що сервер у виклику API: розташування, OAuth, протокол, контракт, payload, трасування й налагодження, помилки

Обов’язки сервера

Хай сервером виступає Salesforce чи зовнішня система, обов’язки ті самі. Сервер має бути доступним, мати процес-слухач на певному порту (зазвичай 443 для SSL) і, можливо, сервер автентифікації, якщо використовується OAuth. Сервер визначає протокол, надає клієнтові потрібні файли, вирішує щодо payload і може трасувати вхідний payload і продуктивність внутрішньої обробки.

Обов’язки клієнта

Клієнт має знати endpoint, обробляти токени сесії й бути готовим до помилок закінчення сесії. Він має викликати відповідний протокол, правильно серіалізувати дані й обробляти значення, що повертаються. Клієнт може трасувати вихідні payload, вхідні відповіді й обробляти різні помилки, а відповідальність за перехоплення й усунення цих помилок лежить на сервері.

Salesforce як сервер

Діаграма: API Salesforce, які може викликати зовнішній клієнт (SOAP, REST, Bulk, Apex SOAP і REST, Metadata, Tooling, Streaming і Pub/Sub) після автентифікації через connected app та інтеграційного користувача

Коли Salesforce діє як сервер, для налаштування OAuth може знадобитися connected app, інтеграційний профіль та інтеграційний користувач. Клієнтами можуть бути різні зовнішні системи, що звертаються до 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. Для різних вихідних механізмів потрібні різні налаштування, і кожен дотримується описаних вище протоколів клієнт-сервер.

Висновок

Розуміння танцювальних рухів взаємодії клієнт-сервер у викликах API Salesforce критично важливе для ефективного використання API. Ми розібрали обов’язки обох сторін і дослідили сценарії із зовнішніми клієнтами та Salesforce у різних ролях.

Слідкуйте за новинами

Більше думок і порад — тут, на www.SteveTechArc.com, і на YouTube-каналі @SteveTechArc (opens in a new tab). Підпишіться й поглиблюйте розуміння Salesforce і того, як інтегрувати його з іншими системами.

Допомагаю змінювати світ, ділячись знаннями про інтеграцію з колегами-архітекторами і тими, хто йде до архітектури!

Пірнайте глибше в технологічний шведський стіл і продовжуйте бенкетувати технологіями. Лишайтеся ботанами!

Транскрипт оброблено за допомогою ШІ

STA 1.3