Переведено ИИ. Сообщество еще не проверило перевод. Читать на английском

Блог · 7 сентября 2023 г. · Steve Simpson · Интеграция

Танго Salesforce: разбираемся в API-танце клиента и сервера.

Введение

Здесь — о том, как понимать взаимодействие клиента и сервера при вызовах API в Salesforce. Это важная часть нашей серии об интеграции на stevetecharc.com.

Танго Salesforce: танец взаимодействия

В сложном танце вызовов API важно понимать движения. Схема, о которой я сейчас расскажу, показывает танцевальные движения — то есть взаимодействие клиента и сервера.

Схема: за что отвечают клиент и сервер в вызове API: расположение, OAuth, протокол, контракт, полезная нагрузка, трассировка и отладка, ошибки

Обязанности сервера

Кто бы ни выступал сервером — Salesforce или внешняя система, — обязанности остаются теми же. Сервер должен быть доступен, иметь процесс, слушающий определенный порт (обычно 443 для SSL), и, возможно, сервер аутентификации, если используется OAuth. Сервер определяет протокол, предоставляет клиенту нужные файлы, решает, какой будет полезная нагрузка, и может трассировать входящую нагрузку и производительность внутренней обработки.

Обязанности клиента

Клиент должен знать конечную точку, обрабатывать маркеры сеанса и быть готовым к ошибкам истечения сеанса. Ему нужно вызывать правильный протокол, корректно сериализовать данные и обрабатывать возвращаемые значения. Клиент может трассировать исходящую нагрузку и входящие ответы и обрабатывать различные ошибки, при этом ответственность за перехват и устранение этих ошибок лежит на сервере.

Salesforce как сервер

Схема: API Salesforce, которые может вызывать внешний клиент (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, исходящие сообщения, Salesforce Connect с OData и Heroku Connect

Salesforce может выступать и клиентом, выполняя исходящие вызовы к внешним серверам. Для этого может понадобиться импортировать файлы WSDL, сгенерировать Apex и настроить именованные учетные данные для серверов SOAP и REST. Разные исходящие механизмы требуют разных настроек, и каждый следует описанным выше протоколам клиент–сервер.

Заключение

Понимать танцевальные движения взаимодействия клиента и сервера в вызовах API Salesforce крайне важно для эффективной работы с API. Мы разобрали обязанности обеих сторон и рассмотрели сценарии с внешними клиентами и Salesforce в разных ролях.

Следите за новостями

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

Помогаем менять мир, делясь знаниями об интеграции с коллегами-архитекторами и теми, кто идет по пути к профессии архитектора!

Ныряйте в технический шведский стол и продолжайте пировать технологиями. Оставайтесь гиками!

Расшифровка сделана с помощью ИИ

STA 1.3