Descontinuação de versões legadas da API do Lightning Platform

O que está mudando?

Com a versão Summer '21, as seguintes versões legadas da API do Lightning Platform serão descontinuadas e não terão mais suporte no Salesforce:

• 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: v20.0

• Em massa: 16.0, 17.0, 18.0, 19.0, 20.0

Os clientes podem continuar usando essas versões legadas da API até a versão Summer '21 ser lançada, quando essas versões legadas ficarão indisponíveis. Quando essas versões legadas são descontinuadas, os aplicativos que consomem as versões afetadas das APIs sofrerão uma interrupção, pois as solicitações falharão e resultarão em um erro de API indicando que o ponto de extremidade solicitado foi desativado. 

Quais providências devo tomar? 

Antes da versão Summer '21, os clientes precisarão modificar ou atualizar os aplicativos para que funcionem com as versões mais atuais da API para prevenir qualquer interrupção causada por o software fazer referência a versões descontinuadas. A mudança para versões mais novas de nossas APIs oferecerá recursos avançados com maior segurança e desempenho.

Como sei se as versões afetadas das APIs legadas são usadas em meus aplicativos?

Para identificar aplicativos que utilizam APIs que serão descontinuadas, entre em contato com os desenvolvedores dos aplicativos que você usa na sua organização para determinar quais versões da API estão sendo utilizadas. 
 

Se você não puder entrar em contato com os desenvolvedores dos aplicativos, será possível analisar os registros de evento que relatam a atividade das APIs SOAP e REST de suas organizações do Salesforce seguindo estas etapas:

1. Use uma ferramenta como o Salesforce CLI para executar uma consulta SOQL no objeto EventLogFile, que fornecerá um log de todas as ações tomadas em sua organização durante as últimas 24 horas.

   1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <your-username>

2. Para cada resultado, realize uma solicitação REST usando o ponto de extremidade para obter os dados e copiá-los para um arquivo .CSV.

   1. Por exemplo, /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Cole o corpo da resposta em um aplicativo como o Excel para ver mais facilmente os dados do registro de evento como um arquivo .CSV.

3. Analise cada arquivo .CSV e determine se as solicitações estão sendo feitas para os pontos de extremidade com versões da API inferiores à 20.

   1. SOAP/API EventType – analise os valores na coluna API_VERSION para registros de API_TYPE de "E" ou "P"

   2. REST/RestApi EventType – analise os valores no URI da coluna e anote os pontos de extremidade que apresentam "v20.0" ou inferior no caminho

4. Todas as integrações que consomem as versões 20 ou inferiores serão afetadas pela descontinuação dessa API.

Para obter mais informações, consulte o Módulo de Trailhead Como baixar e visualizar arquivos de log de eventos. 

Para a API em massa, navegue para a página "Trabalhos de carregamento de dados em massa" em Configuração e veja os detalhes de cada trabalho "Em massa V1". Qualquer trabalho que apresente um valor de 20.0 ou inferior no campo "Versão da API" será afetado pela descontinuação dessa API. 

Por que vocês estão descontinuando este produto?

Estamos concentrando nossos esforços de desenvolvimento no aprimoramento das versões mais recentes da API para melhorar a experiência geral do Salesforce ao criar uma funcionalidade personalizada por meio de aplicativos. 

Como posso obter mais informações?

Para obter mais informações sobre que recursos são compatíveis com a versão mais recente da API SOAP, acesse o site do Desenvolvedores do Salesforce e consulte a documentação a seguir:

• Introdução ao guia de desenvolvedor da API SOAP

• Introdução à API REST do Lightning Platform

• Introdução à API em massa

Para dúvidas adicionais, você pode abrir um caso no Suporte ao cliente por meio do portal Ajuda e treinamento.