Descontinuação da API do Salesforce Platform versões 31.0 a 40.0

Atualizado em 30 de abril de 2026

Data da publicação original: 30 de abril de 2026

Qual o status das versões 31.0 a 40.0 das APIs SOAP, REST e em massa?

• Atual: Essas versões de API atualmente são suportadas.

• Futuro: Versão Summer '27 – Essas versões de API se tornarão obsoletas e não serão mais suportadas. Você pode usá-las, mas, se tiver problemas e registrar um caso no suporte do Salesforce, será necessário atualizar a versão da API. Não haverá soluções de problemas nem correções de bugs para essas versões de API.

• Futuro: Versão Summer '28 – Essas versões de API serão descontinuadas e removidas da plataforma. Os aplicativos que consomem essas versões serão interrompidos, porque as chamadas da API falharão e responderão com um erro dizendo que o ponto de extremidade solicitado não foi encontrado e não pode ser processado pela plataforma. Consulte os erros abaixo:

  • A API REST retorna 410: GONE.

  • A API SOAP retorna 500: UNSUPPORTED_API_VERSION.

  • A API em massa retorna 400: InvalidVersion.

Nota: As API versões 21.0 a 30.0 já foram descontinuadas e estão indisponíveis na versão Summer '25.

Por que estamos descontinuando essas versões de API?

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. Para colocar as coisas em perspectiva, a versão 31.0 da API era da nossa versão Spring '14.

O que essa descontinuação de versão da API afeta?

Essa descontinuação afeta qualquer código, pacote, aplicativo ou integração que execute uma solicitação das versões 31.0 a 40.0 da API SOAP, REST ou Em massa.

Nota: Essa descontinuação não afeta o seguinte:

• As versões de API das classes do Apex, dos acionadores do Apex, das páginas do Visualforce, dos fluxos e dos criadores de processo

• O produto B2B Classic/Visualforce pronto para uso

• Componentes de metadados com controle de versão em um pacote gerenciado

• Serviços da Web REST e SOAP personalizados do Apex (Um serviço da Web personalizado do Apex é uma maneira de tornar um método de classe do Apex que possa ser chamado como uma API pública). Você pode aprender mais sobre os serviços da Web do Apex aqui: Serviços da Web do Apex)

O que preciso fazer?

1. Identifique os componentes/aplicativos em sua organização que usam essas versões de API legadas.

2. Atualize esses componentes/aplicativos. Antes da versão Summer '28, você deve modificar ou fazer upgrade de seus aplicativos para que funcionem com as versões atuais e com suporte da API. A Salesforce recomenda enfaticamente migrar para versões mais recentes das APIs, pois elas proporcionam recursos avançados com desempenho e segurança aprimorados.

Consulte a tabela abaixo para ver alguns locais comuns que podem ser afetados e quais ações tomar para cada:

Como sei se/onde as versões da API legada são usadas em meus aplicativos?

Entre em contato com os desenvolvedores dos aplicativos que você usa para determinar as versões da API.

Você pode revisar eventos de API no EventLogFile de uso total da API que relatam atividade de API SOAP, REST e Em massa. O tipo de evento de Uso total da API consolida informações de solicitação de APIs SOAP, REST e Em massa, incluindo as informações de versão.

Organizações habilitadas para API têm acesso aos arquivos de logs de evento de Uso total da API das últimas 24 horas.

Organizações com Monitoramento de evento habilitado podem acessar esse e outros tipos de arquivos de logs com retenção de dados de 30 dias (que pode ser aumentado para até um ano através das Configurações de Monitoramento de evento ou usando a API de metadados EventSettings). Para mais informações sobre o Monitoramento de evento, faça o Módulo do Trailhead de Monitoramento de evento.

Para analisar esses eventos de Uso total da API, primeiro você precisa baixá-los como arquivos CSV usando um dos três métodos descritos abaixo.

1. O primeiro método é usar o novo Navegador de log de evento incluso na versão Summer '24. Com isso, você pode navegar nos arquivos de logs de evento Uso total da API na sua organização e baixá-los como arquivos CSV para visualizar os eventos de API individuais.

Em Configuração, navegue para Segurança → Monitoramento de evento → Navegador de log de evento. Aqui você pode visualizar os arquivos de log de evento para as últimas 24 horas (ou os últimos 30 dias se tiver ativado o Monitoramento de evento). Você então pode baixar arquivos de logs de evento como arquivos CSV para visualizar os eventos da API neles.

2. O segundo método consiste em usar essa ferramenta fornecida pela Salesforce para automatizar o download diário dos dados de uso total da API para recuperar os dados das últimas 24 horas. Trata-se de um script em Python que extrai os dados do EventLogFile de Uso total da API e os baixa em arquivos CSV. O script em Python usa a Salesforce CLI para autenticação e recuperação de dados.

3. O terceiro método é usar manualmente um cliente como a Salesforce CLI para executar uma consulta SOQL com relação ao objeto EventLogFile, fornecendo os arquivos de logs de evento para as últimas 24 horas (ou os últimos 30 dias* se você tiver ativado o Monitoramento de evento).

sf data query -q "SELECT Id, LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('ApiTotalUsage')" -o <your-username>

Para cada resultado, realize uma solicitação de API REST para pontos de extremidade no resultado da consulta para recuperar os dados de log do evento no arquivo de logs de evento.*

/services/data/v66.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

Cole o corpo da resposta em um aplicativo para inspecionar facilmente os dados do log de evento como um arquivo .CSV.

*Para informações de introdução sobre como realizar a solicitação da API REST, consulte este trailhead Usar a API REST.

Quando os eventos de API no EventLogFile de Uso total da API tiverem sido baixados em arquivos CSV, revise cada arquivo CSV e identifique todas as solicitações com API_VERSION de 40 e inferiores.

Para solicitações de API com versões de API 40.0 e inferiores, siga as dicas fornecidas pelos seguintes campos principais nos dados do log de evento para ajudar a identificar a origem da chamada de API:

• CONNECTED_APP_ID e CONNECTED_APP_NAME indicam o Aplicativo conectado ou o Aplicativo cliente externo que fez a chamada de API.

  • Um CONNECTED_APP_ID que começa com 0H4 indica um Aplicativo conectado.

  • Um CONNECTED_APP_ID que começa com 0xI indica um Aplicativo cliente externo.

• CLIENT_NAME é um cabeçalho opcional fornecido por clientes para ajudar a identificar aplicativos que fazem as chamadas de API.

• USER_NAME identifica o usuário na sua organização que é usado para autenticar as chamadas de API. Embora isso possa ser útil na identificação do cliente de origem, saiba que a mesma conta de usuário do sistema pode ser compartilhada por vários clientes.

• CLIENT_IP é o endereço IP do cliente que faz a solicitação, mas tenha cuidado caso diversos clientes do mesmo local físico compartilhem o mesmo endereço IP.

Os parceiros podem aproveitar os Logs de uso do pacote para percepções sobre o consumo da API preterida.

Como posso saber onde essas versões de API legadas são usadas em meu código?

Você pode usar o Salesforce Code Analyzer para saber onde essas versões de API legadas são usadas em seu código. Consulte esta documentação.

Salesforce para Outlook

Chamadas da API que são originadas do Salesforce para Outlook terão um CLIENT_NAME de "SfdcApplication/" no EventLogFile de Uso total da API. Atualize para a versão mais recente do Salesforce para Outlook que usa uma versão da API com suporte.

Microsoft Power Query

Se as chamadas da API do Microsoft Power Query estiverem usando essas versões de API obsoletas, siga estas instruções para atualizar a versão da API que o Microsoft Power Query usa.

Como posso obter mais informações?

Sobre as versões da API mais recentes com suporte, acesse o site de Desenvolvedores do Salesforce.

Sobre APIs e mensagens de saída:

• Noções básicas sobre a API Platform (Trailhead)

• Introdução à API SOAP (Guia do desenvolvedor)

• Mensagem de saída (Guia do desenvolvedor)

• Introdução à API Em massa 2.0 e API Em massa (Guia do desenvolvedor)

• Introdução à API REST (Guia do desenvolvedor)

  • "REST" cobre todas as APIs com URIs de ponto de extremidade em /services/data/vXX.Y/ e /services/metadata/vXX.Y/ em que XX.Y é a versão da API. Isso inclui a API REST da Salesforce Platform "padrão" para trabalhar com sObjects e registros, mas também os seguintes recursos:

    • Desenvolvedor da API de metadados

    • API de conjunto de ferramentas

    • API do Chatter/Connect

    • APIs Consultar e Consultar tudo

    • API de pesquisa

    • API de limites

    • API de login (também conhecida como "Identidade")

  • Observe os resultados de uma solicitação REST para GET /services/data/v40.0 ou GET /services/metadata/v40.0 para entender os recursos de alto nível afetados quando pontos de extremidade v40.0 e inferiores são descontinuados.

Ainda preciso de ajuda. O que posso fazer?

• Veja os recursos acima.

• Publique na Trailblazer Community.

• Entre em contato com o Suporte da Salesforce através da Ajuda do Salesforce. Lembre-se do que você já tentou e onde está a dificuldade para que a equipe de suporte possa ajudá-lo do modo mais eficiente possível. Observe que a equipe de Suporte não pode atualizar as APIs legadas em sua organização.

Consulte as Descontinuações de recursos e produtos Salesforce para visualizar todas as descontinuações atuais e passadas. Para saber mais sobre a abordagem da Salesforce em relação à descontinuação, leia nossa Filosofia de descontinuação de produtos e recursos.