Прекращение поддержки устаревших версий Lightning Platform API

Что изменилось?

В выпуске Summer'21 компания Salesforce планирует прекратить поддержку указанных ниже устаревших версий Lightning Platform API.

• SOAP: 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0, 20.0

• REST: 20.0

• Bulk: 16.0, 17.0, 18.0, 19.0, 20.0

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

Что необходимо сделать? 

Во избежание нестабильной работы в результате использования программного обеспечения, ссылающегося на версии, поддержка которых прекращена, клиентам рекомендуется изменить или обновить имеющиеся приложения путем внедрения последних доступных версий API до выпуска Summer'21. Более новые версии интерфейсов API предоставляют расширенные возможности, а также обеспечивают повышенную безопасность и производительность.

Как определить использование указанных версий устаревших интерфейсов API в приложениях?

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

В противном случае, просмотрите журналы событий, регистрирующие действия SOAP API и REST API, в организации Salesforce. Выполните указанные ниже действия.

1. Воспользуйтесь инструментом (например, Salesforce CLI) для выполнения запроса SOQL в отношении объекта EventLogFile с целью получения журнала всех действий, выполненных внутри организации за последние 24 часа.

   1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <имя_пользователя>

2. Выполните запрос REST для каждого результата. Воспользуйтесь конечной точкой для получения и копирования данных в CSV-файл.

   1. Например, /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile.

   2. Вставьте текст ответа в приложение (например, Excel) для более удобного просмотра данных журнала событий в виде CSV-файла.

3. Просмотрите каждый CSV-файл и определите, выполняются ли запросы на конечные точки, которые используют API 20.0 или более ранней версии.

   1. SOAP/API EventType: просмотрите значения в столбце API_VERSION для записей, API_TYPE которых задано значение "E" или "P".

   2. REST/RestApi EventType: просмотрите значения в столбце URI и найдите конечные точки, путь которых содержит "/v20.0" или более раннюю версию.

4. Прекращение поддержки повлияет на все интеграции, использующие API 20.0 или более ранней версии.

Дополнительную информацию см. в модуле Trailhead "How to Download and Visualize Event Log Files". 

При использовании Bulk API откройте страницу "Задания на загрузку массива данных" в меню "Настройка" и просмотрите сведения о каждом задании "Bulk V1". Данное прекращение поддержки повлияет на все задания, поле "Версия API" которых содержит значение "20.0" или ниже. 

Почему прекращается поддержка данного продукта?

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

Где можно получить более подробную информацию?

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

• Общие сведения о SOAP API

• Общие сведения о Lightning Platform REST API

• Введение в Bulk API

При возникновении дополнительных вопросов зарегистрируйте обращение в службу поддержки посредством портала "Справка и обучение".