Retrait des versions héritées de l’API Lightning Platform

En quoi consiste cette modification ?

Avec la publication de la version Summer ‘21, les versions héritées suivantes de l’API Lightning Platform seront supprimées et ne seront plus prises en charge par 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

• Transfert de données en masse : 16.0, 17.0, 18.0, 19.0, 20.0

Les clients pourront continuer à utiliser ces versions d’API héritées jusqu’à la publication de Summer ‘21, date à laquelle ces versions héritées ne seront plus disponibles. Lorsque ces versions héritées seront supprimées, les applications utilisant les versions impactées des API subiront une interruption car les demandes échoueront et entraîneront une erreur indiquant que le point de terminaison demandé a été désactivé. 

Quelle est la mesure à prendre ? 

Avant la publication de la version Summer ‘21, les clients devront modifier ou mettre à niveau leurs applications pour qu’elles fonctionnent avec les version les plus récentes des API disponibles, afin d’éviter toute interruption provoquée par le référencement logiciel des versions supprimées. En migrant vers les versions plus récentes de nos API, les clients bénéficieront de capacités avancées et d’une amélioration des performances et de la sécurité.

Comment puis-je déterminer si des versions impactées des API héritées sont utilisées dans mes applications ?

Pour identifier les applications qui utilisent des API qui seront supprimées, contactez les développeurs des applications que vous utilisez dans votre organisation afin de déterminer ces versions d'API. 
 

Si vous ne pouvez pas contacter les développeurs de vos applications, consultez les journaux des événements qui signalent l’activité de l’API REST et SOAP de votre organisation Salesforce en procédant comme suit :

1. Utilisez un outil tel que le Salesforce CLI pour exécuter une requête SOQL sur l’objet EventLogFile, qui renvoie un journal de toutes les actions exécutées dans votre organisation au cours des dernières 24 heures.

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

2. Pour chaque résultat, exécutez une requête REST en utilisant le point de terminaison pour obtenir les données et les copier dans un fichier .CSV.

   1. Par exemple /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Copiez le corps de la réponse dans une application telle qu’Excel pour afficher plus facilement les données des journaux des événements en tant que fichier .CSV.

3. Examinez chaque fichier .CSV et déterminez si les demandes sont faites auprès des points de terminaison avec les versions d’API antérieures à 20.

   1. EventType SOAP/API -- Examinez les valeurs de la colonne API_VERSION pour les enregistrements de API_TYPE « E » ou « P »

   2. EventType REST/RestApi -- examinez les valeurs de la colonne URI et notez les points de terminaison avec « /v20.0 » ou inférieur dans le chemin

4. Toutes les intégrations qui consomment les versions 20 et inférieures vont être impactées par ce retrait d’API.

Pour plus d’informations, suivez le module Trailhead Téléchargement et visualisation des fichiers journaux d'événements. 

Pour l’API de transfert en masse, accédez à la page « Tâches de chargement de données en masse » dans Configuration et affichez les détails de chaque tâche « Transfert en masse V1 ». Toutes les tâches qui présentent une valeur de 20.0 ou inférieure dans le champ « Version d’API » vont être impactés par ce retrait d’API. 

Pourquoi retirez-vous cette fonctionnalité ?

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. 

Comment puis-je obtenir plus d'informations ?

Pour plus d'informations sur les fonctionnalités prises en charge par la dernière version d’API SOAP, consultez le site Salesforce Developer et reportez-vous à la documentation suivante :

• Présentation de SOAP API Developer Guide

• Présentation de l’API REST de Lightning Platform

• Présentation de l’API de transfert en masse

Si vous avez d'autres questions, ouvrez une requête auprès du Support client via le portail Aide et formation.