Retrait des versions d'API Salesforce Platform 31.0 à 40.0

Mise à jour - 30 avril 2026

Date originale de publication - 30 avril 2026

Quel est le statut des versions 31.0 à 40.0 des API SOAP, REST et de transfert en masse ?

• Actuellement : Les versions d’API suivantes sont prises en charge actuellement.

• À l’avenir : Version Summer '27 – Ces versions d’API seront dépréciées et ne seront plus prises en charge. Vous pouvez les utiliser, mais si vous rencontrez des problèmes et consignez une requête auprès du Support Salesforce, vous devez d’abord mettre à jour la version d’API. Il n’y aura pas de dépannage ni de correctif de bogues pour ces versions d’API.

• À l’avenir : Version Summer ‘28 – Ces versions d’API vont être retirées et supprimées de la plate-forme. Les applications qui utilisent ces versions seront interrompues car les appels d’API échoueront et répondront avec une erreur indiquant que le point de terminaison demandé est introuvable et que la demande ne peut pas être traitée par la plate-forme. Voici les erreurs :

  • L’API REST renvoie l’erreur 410 : GONE.

  • L’API SOAP renvoie l’erreur 500 : UNSUPPORTED_API_VERSION.

  • L’API de transfert en masse renvoie l’erreur 400 : InvalidVersion.

Remarque : Les versions d’API 21.0 à 30.0 ont déjà été retirées et sont devenues indisponibles lors de la version Summer ’25.

Pourquoi retirons-nous ces versions d’ API ?

Nous orientons nos efforts de développement vers l’amélioration des dernières versions d’API afin d’optimiser l’expérience globale de Salesforce lors de l’élaboration de fonctionnalités personnalisées via des applications. Pour mettre les choses en perspective, la version d’API 31.0 datait de notre version Spring ‘14.

Quel est l’impact du retrait de la version d’API ?

Ce retrait affecte le code, les packages, les applications ou les intégrations qui exécutent une requête de versions 31.0 à 40.0 des API SOAP, REST, ou de transfert en masse.

Remarque : Ce retrait n’affecte pas les éléments suivants :

• Les versions d’API des classes Apex, déclencheurs Apex, pages Visualforce, flux et générateurs de processus

• Le produit prêt à l'emploi B2B Classic/Visualforce

• Composants de métadonnées par version dans un package géré

• Services Web REST & SOAP Apex personnalisés (un service Web Apex personnalisé permet d’appeler une méthode de classe Apex comme API publique°. Pour plus d'informations sur les services Web Apex, suivez ce lien : Services Web Apex)

Quelles sont les mesures à prendre ?

1. Identifiez les composants/applications dans votre organisation qui utilisent ces anciennes versions d’API.

2. Mettez à jour ces composants/applications. Avant la version Summer '28, vous devez modifier ou mettre à niveau vos applications pour qu’elles fonctionnent avec les versions d’API actuelles qui sont prises en charge. Salesforce recommande vivement de migrer vers les versions plus récentes des API pour bénéficier de capacités avancées et d’une amélioration des performances et de la sécurité.

Consultez le tableau ci-dessous répertoriant les composants couramment impactés et les mesures à prendre pour chacun d’eux :

Comment puis-je déterminer si ces anciennes versions d’API sont utilisées dans mes applications et à quel endroit ?

Pour déterminer les versions d’API, contactez les développeurs des applications que vous utilisez.

Vous pouvez passer en revue les événements API dans le API Total Usage EventLogFile (gratuit) qui rend compte de l’activité des API SOAP, REST et de transfert en masse. Le type d’événement « API Total Usage » regroupe les informations de requête des API REST, SOAP, et de transfert en masse, ainsi que des informations de version.

Les organisations dont l’API est activée peuvent accéder aux fichiers journaux d’événements API Total Usage des 24 heures précédentes.

Les organisations dont la Surveillance des événements est activée peuvent y accéder ainsi qu’à tous les autres types de journal des événements avec une rétention des données de 30 jours (qui peut être augmentée jusqu’à un an dans les Paramètres Surveillance des événements ou à l’aide de l’API de métadonnées EventSettings). Pour en savoir plus sur la surveillance des événements, suivez le module Trailhead Surveillance des événements.

Pour examiner ces événements d’API Total Usage, vous devez d’abord les télécharger dans un fichier CSV à l’aide de l’une des trois méthodes décrites ci-dessous.

1. La première méthode consiste à utiliser le nouveau navigateur de fichiers journaux d’événements inclus dans la version Summer ‘24. Il vous permet de parcourir les fichiers journaux d’événements de l’utilisation totale de l’API sur votre organisation et de les télécharger sous forme de fichiers CSV afin de visualiser les événements d’API individuels.

Dans Configuration, accédez à Sécurité → Surveillance des événements → Navigateur de fichiers journaux d’événements. Vous pouvez consulter ici les fichiers journaux d’événements des dernières 24 heures (ou des 30 derniers jours si vous avez activé Surveillance des événements). Vous pouvez ensuite télécharger des fichiers journaux d’événements individuels sous forme de fichiers CSV afin de visualiser les événements API qui y figurent.

2. La deuxième méthode consiste à utiliser cet outil fourni par Salesforce pour automatiser le téléchargement quotidien des données d’utilisation totale d’API afin de récupérer les dernières 24 heures de données. Il s’agit d’un script Python qui extrait les données dans API Total Usage EventLogFile et le télécharge dans des fichiers CSV. Le script Python utilise Salesforce CLI pour l’authentification et la récupération de données.

3. La troisième méthode consiste à utiliser manuellement un client tel que Salesforce CLI afin d’exécuter une requête SOQL sur l’objet EventLogFile, fournissant les fichiers journaux d’événements pour les dernières 24 heures (ou les 30 derniers jours* si vous avez activé la Surveillance des événements).

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

Pour chaque résultat, effectuez une requête d’API REST à l’aide des points de terminaison dans le résultat de requête pour récupérer les données des journaux d’événements dans ce fichier journaux d’évènements*.

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

Collez le corps de la réponse dans une application pour inspecter facilement les données des journaux d’événements en tant que fichier CSV.

*Pour obtenir des informations d’introduction sur l’exécution d’une requête API REST, consultez le module Trailhead Utilisation de l’API REST.

Lorsque les événements d’API dans API Total Usage EventLogFile ont été téléchargés dans des fichiers CSV, examinez chaque fichier CSV et identifiez toutes les requêtes avec des versions API_VERSION 40 et inférieures.

Pour les requêtes d’API avec des versions d’API 40.0 et des versions inférieures, suivez les indications fournies par les champs clés suivants dans les données des journaux d’événements pour identifier la source de l’appel d’API :

• CONNECTED_APP_ID et CONNECTED_APP_NAME indiquent l’Application connectée ou l’Application cliente externe qui a effectué l’appel d’API.

  • UN CONNECTED_APP_ID commençant par 0H4 indique une Application connectée.

  • UN CONNECTED_APP_ID commençant par 0xI indique une Application cliente externe.

• CLIENT_NAME est un en-tête facultatif fourni par les clients pour aider à identifier les applications qui effectuent les appels d’API.

• USER_NAME identifie l’utilisateur dans votre organisation qui est utilisé pour authentifier les appels d’API. Même si cela peut être utile pour identifier le client d’origine, veuillez noter que le même compte utilisateur système peut être partagé par des clients multiples.

• CLIENT_IP est l’adresse IP du client demandeur, mais soyez vigilant si plusieurs clients du même emplacement physique partagent la même adresse IP.

Les partenaires peuvent tirer parti des Package Usage Logs (en anglais) pour obtenir des informations sur leur utilisation d’API obsolète.

Comment puis-je déterminer à quel endroit ces anciennes versions d’API sont utilisées dans mon code ?

Vous pouvez utiliser l’Analyseur de code Salesforce pour déterminer à quel endroit ces anciennes versions d’API sont utilisées dans votre code. Reportez-vous à cette documentation.

Salesforce pour Outlook

Les appels d’API provenant de Salesforce pour Outlook auront un CLIENT_NAME « SfdcApplication/ » dans l’API Total Usage EventLogFile. Mettez à niveau vers la dernière version de Salesforce pour Outlook qui utilise une version d’API prise en charge.

Microsoft Power Query

Si les appels d’API provenant de Microsoft Power Query utilisent ces versions d’API obsolètes, suivez ces instructions pour mettre à jour la version d’API utilisée par Microsoft Power Query.

Comment obtenir des informations supplémentaires ?

En ce qui concerne les dernières versions d’API prises en charge, consultez le site Salesforce Developers.

À propos des API et des messages sortants :

• Bases de l’API de la plate-forme (Trailhead)

• Introduction to SOAP API (en anglais) (Guide du développeur)

• Outbound Messaging (en anglais) (Guide du développeur)

• Introduction to Bulk API 2.0 and Bulk API (en anglais) (Guide du développeur)

• Introduction to REST API (en anglais) (Guide du développeur)

  • « REST » couvre toutes les API avec des URI de point de terminaison sous /services/data/vXX.Y/ et /services/metadata/vXX.Y/ où XX.Y est la version d’API. Cela inclut l’API REST Salesforce Platform « standard » qui fonctionne avec sObjects et les enregistrements, mais également les ressources suivantes :

    • Metadata API Developer (en anglais)

    • Tooling API (en anglais)

    • Chatter/Connect API (en anglais)

    • Query and Query All APIs (en anglais)

    • Search API (en anglais)

    • Limits API (en anglais)

    • Login API (c’est-à-dire « URL d'identité »)

  • Observez les résultats d'une requête REST sur GET /services/data/v40.0 ou GET /services/metadata/v40.0 pour comprendre les ressources de niveau supérieur affectées lors du retrait des points de terminaison des versions v40.0 et des versions inférieures.

J’ai encore besoin d’aide. Que puis-je faire ensuite ?

• Accédez aux ressources ci-dessus.

• Publiez une publication dans la Trailblazer community.

• Contactez le Support Salesforce via l’Aide de Salesforce. Notez ce que vous avez déjà essayé et à quel endroit vous êtes bloqué pour que le Support puisse vous aider au mieux. Notez que le Support ne peut pas mettre à jour les API héritées dans votre organisation.

Vous pouvez consulter les Retraits de fonctionnalités Salesforce pour afficher les retraits actuels et passés. Pour en savoir plus sur l’approche de retrait de Salesforce, lisez notre Philosophie de retrait de fonctionnalité.