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

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

По всем API: обзор API Salesforce

Добро пожаловать в новый выпуск серии об интеграции. На этот раз мы исследуем сложный мир API Salesforce — ключевого элемента эффективных интеграций.

Введение в API Salesforce

Как ориентироваться в API Salesforce

Salesforce предлагает множество API, каждый из которых служит своей цели и дает свои возможности. Это руководство проведет вас по ним и поможет понять, как эффективно использовать их в разных задачах интеграции.

Разбираемся с аутентификацией

Прежде чем погружаться в API, важно понять процесс аутентификации. Когда браузер обращается к Salesforce, он проходит аутентификацию на сервере, прежде чем попасть к закрытому содержимому. Эта аутентификация важна, обращаетесь ли вы к общедоступным сайтам, порталам Experience или даже к общедоступным страницам для функций Web-to-Lead и Web-to-Case.

Схема: доступ к Salesforce и API. Клиентское приложение и браузер проходят аутентификацию через сервер аутентификации, а затем обращаются к версионируемым веб-сервисам (стандартным API), неверсионируемым пользовательским сервисам REST и SOAP, общедоступным сайтам, Web-to-Lead и Email-to-Case

Версионируемые и неверсионируемые веб-сервисы

Почему важны версии

Salesforce выпускает API под определенными номерами версий и годами сохраняет их возможности и совместимость, пока в конце концов не выводит их из употребления.

Как потребитель вы должны знать, какую версию используете, и быть готовы перейти на более новые версии (с тестированием).

Пользовательские API REST и SOAP

Для пользовательских API REST или SOAP, которые вы создаете сами, Salesforce не обеспечивает версионирование. Управлять ими и поддерживать их — ваша ответственность, чтобы они работали как ожидается после каждого обновления Salesforce.

Схема: API Salesforce, которые может вызывать внешний клиент (SOAP, REST, Bulk, Apex SOAP и REST, Metadata, Tooling, Streaming и Pub/Sub), после аутентификации через подключенное приложение и пользователя интеграции

Аутентификация внешних клиентов

Когда внешние клиенты обращаются к Salesforce, они должны пройти аутентификацию через определенные потоки. Клиенты бывают самыми разными: клиенты SOAP, использующие Enterprise или Partner WSDL, клиенты REST, клиенты Bulk API и многие другие.

Знакомство с разными API

У Salesforce широкий набор API, каждый из которых рассчитан на определенные задачи и функции. От новой шины событий Salesforce до API для разных отраслей, таких как здравоохранение и производство, — API найдется почти для любой потребности.

Снимок экрана: страница Browse APIs на сайте Salesforce Developers со списком карточек API

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

Инструменты и ресурсы

Postman: лучший друг разработчика

Для разработчиков, работающих с API Salesforce, такие инструменты, как Postman, просто незаменимы. Postman позволяет выполнять аутентификацию и запросы и даже вставлять, редактировать, обновлять или удалять данные извне Salesforce, что делает его обязательным инструментом для тестирования и разработки с API.

Снимок экрана: запрос Postman, выполняющий запрос SOQL к REST API Salesforce, с заголовком авторизации и ответом JSON

Документация и коллекции

Знакомство с доступной документацией — ключ к освоению API Salesforce. Такие ресурсы, как REST API Developer Guide и многочисленные коллекции Postman на GitHub, могут заметно облегчить вашу разработку.

Заключение:

Понимать и эффективно использовать API Salesforce крайне важно для любого разработчика интеграций или архитектора, работающего с Salesforce. Имея в распоряжении широкий набор API и инструментов, вы можете эффективно обрабатывать, читать, редактировать и обновлять как данные, так и конфигурацию в Salesforce.

Исследуйте, экспериментируйте и интегрируйте!

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

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

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

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

STA 1.9