Tilbaketrekking av eldre API-versjoner for Lightning-plattformen

Hva blir endret?

Med Summer '21-utgivelsen vil følgende eldre API-versjoner for Lightning-plattformen bli trukket tilbake og ikke lenger bli støttet 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 fortsette å bruke disse eldre API-versjonene frem til Summer '21-utgivelsen. Da vil disse eldre versjonene bli utilgjengelige. Når disse eldre versjonene blir trukket tilbake, vil programmer som benytter berørte versjoner av APIene, oppleve avbrudd ettersom forespørsler vil mislykkes og føre til feil som indikerer at det aktuelle endepunktet har blitt deaktivert. 

Hva må jeg gjøre? 

Før Summer '21-utgivelsen må kunder endre eller oppgradere programmene sine, slik at de bruker de nyeste API-versjonene som er tilgjengelig, for å unngå eventuelle avbrudd som skyldes at programvare refererer til versjoner som er trukket tilbake. Overgang til nyere versjoner av APIene våre vil gi avansert funksjonalitet med forbedret sikkerhet og ytelse.

Hvordan vet jeg om berørte versjoner av eldre APIer er brukt i programmene mine?

Kontakt utviklerne av programmene dere bruker i organisasjonen for å finne ut hvilke API-versjoner som benyttes, slik at du kan identifisere programmer som bruker APIer som er trukket tilbake. 
 

Hvis du ikke kan kontakte utviklerne av programmene, kan du gå gjennom hendelseslogger som rapporterer SOAP og REST API-aktivitet i Salesforce-organisasjonene, ved å følge denne fremgangsmåten:

1. Bruk et verktøy som Salesforce CLI til å utføre en SOQL-spørring mot EventLogFile-objektet, som vil gi deg en logg over alle handlinger i organisasjonen de siste 24 timene.

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

2. Utfør en REST-forespørsel for hvert resultat ved bruk av endepunktet for å få data, og kopier disse til en CSV-fil.

   1. F.eks. /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Lim responsteksten inn i et program som Excel, for lettere å kunne lese data i hendelsesloggen som en CSV-fil.

3. Gå gjennom hver CSV-fil, og finn ut om det gjøres forespørsler til endepunkter med API-versjoner under 20.

   1. SOAP / API EventType -- se gjennom verdier i kolonnen API_VERSION for poster med API_TYPE er lik "E" eller "P"

   2. REST / RestApi EventType -- se gjennom verdier i kolonnen URI og merk deg endepunkter med "/v20.0" eller lavere i banen

4. Eventuelle integrasjoner som bruker versjon 20 eller lavere, vil bli berørt av denne API-tilbaketrekkingen.

Hvis du ønsker mer informasjon, kan du se Trailhead-modulen How to Download and Visualize Event Log Files. 

Når det gjelder Bulk API, går du til siden Massedatalastingsjobber under Oppsett og ser på detaljene for hver Masse V1-jobb. Alle jobber som har verdien 20.0 eller lavere i feltet API-versjon, vil bli berørt av denne API-tilbaketrekkingen. 

Hvorfor opphører dette produktet?

Vi konsentrerer utviklingsarbeidet vårt om å forbedre de nyeste API-versjonene for å forbedre totalopplevelsen av Salesforce når det lages tilpasset funksjonalitet via programmer. 

Hvor finner jeg mer informasjon?

Gå til Salesforce Developer-nettstedet og se følgende dokumentasjon for å få mer informasjon om hvilke funksjoner den nyeste SOAP API-versjonen støtter:

• Introducing SOAP API Developer Guide

• Introducing Lightning Platform REST API

• Introduction to Bulk API

Hvis du har flere spørsmål, kan du åpne en sak hos kundestøtte via Hjelp og opplæring-portalen.