Äldre versioner av Lightning Platform API dras tillbaka

Vad ändras?

Med utgåvan Summer ‘21 kommer följande äldre versioner av Lightning Platform API att dras tillbaka och inte längre stödjas av 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

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

Kunder kan fortsätta att använda dessa äldre API-versioner tills utgåvan Summer ’21 då dessa äldre versioner inte längre är tillgängliga. När dessa äldre versioner dras tillbaka kommer program som använder påverkade versioner av dessa APIs att uppleva störningar eftersom begärandena kommer att misslyckas och resultera i ett fel som anger att den begärda slutpunkten har inaktiverats. 

Vilka åtgärder behöver jag vidta? 

Innan utgåvan Summer ‘21 måste kunder ändra eller uppgradera sina program så att de fungerar med de senaste tillgängliga API-versionerna för att förhindra störningar som orsakas av att programvara refererar till tillbakadragna versioner. Att flytta till nyare versioner av våra APIs kommer att erbjuda avancerad kapacitet med förbättrad säkerhet och prestanda.

Hur vet jag om påverkade versioner av äldre APIs används i mina program?

För att identifiera program som använder APIs som kommer att dras tillbaka, kontakta programutvecklarna som du använder i din org för att avgöra vilka API-versioner som används. 
 

Om du inte kan kontakta programutvecklarna kan du granska dina händelseloggar som rapporterar om SOAP- och REST API-aktivitet från dina Salesforce-organisationer genom att följa dessa steg:

1. Använd ett verktyg som Salesforce CLI för att köra en SOQL-fråga mot objektet EventLogFile, vilket kommer ge dig en logg av alla åtgärder som utförts i din organisation under de senaste 24 timmarna.

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

2. För varje resultat, utför en REST-begäran med slutpunkten för att hämta datan och kopiera dem till en .CSV-fil.

   1. t. ex. /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Klistra in svarets brödtext i ett program som till exempel Excel för att enklare kunna se händelseloggdatan som en .CSV-fil.

3. Granska varje .CSV-fil och avgör om begäranden görs till slutpunkter med API-versioner under 20.

   1. SOAP / API EventType -- granska värden i kolumnen API_VERSION efter poster som är API_TYPE “E” eller “P”

   2. REST / RestApi EventType -- granska värden i kolumnen URI och notera slutpunkter som innehåller “/v20.0” eller lägre i sökvägen.

4. Alla integreringar som använder versionerna 20 och tidigare kommer att påverkas av detta API-tillbakadragande.

Mer information finns i Trailhead-modulen How to Download and Visualize Event Log Files. 

För Bulk API, gå till sidan “Data load-jobb i bunt” i Inställningar och se detaljerna för varje “Bulk V1”-jobb. Jobb som innehåller ett värde på 20.0 eller under i fältet “API-version” kommer att påverkas av detta API-tillbakadragande. 

Varför drar vi tillbaka denna produkt?

Vi fokuserar våra utvecklingsinsatser på att förbättra de senaste API-versionerna för att förbättra den övergripande Salesforce-upplevelsen vid byggande av anpassad funktionalitet via program. 

Hur kan jag få mer information?

För mer information om vilka funktioner som den senaste SOAP API-versionen stöder, gå till webbplatsen Salesforce Developer och se följande dokumentation:

• Introducing SOAP API Developer Guide

• Introducing Lightning Platform REST API

• Introduktion till Bulk API

Om du har ytterligare frågor kan du öppna ett ärende hos Kundsupport via Hjälp- och utbildningsportalen.