Tillbakadragande av Salesforce Platform API-versioner 21.0 till 30.0

Ursprungligt publiceringsdatum - Oktober 20, 2020

Uppdaterat - 4 maj, 2024
 

Vad är status för SOAP, REST och Bulk API-versioner 21-30?

• Aktuellt: Dessa API-versioner är föråldrade (från utgåvan Summer ‘22) och stöds inte längre. Du kan använda dem, men om du stöter på problem och loggar ett ärende med Salesforce Support måste du först uppdatera API-versionen. Det kommer inte att finnas några felsökningar eller buggfixar för dessa äldre API-versioner.

• Framtid: Summer ‘25-utgåvan – Dessa API-versioner kommer att dras tillbaka. Appar som använder versionerna kommer att störas eftersom anrop misslyckas och svarar med ett felmeddelande om att den begärda slutpunkten inte hittas och inte kan bearbetas av plattformen. Nedan är felen:

  • REST API returnerar 410: GONE.

  • SOAP API returnerar 500: UNSUPPORTED_API_VERSION.

  • Bulk API returnerar 400: InvalidVersion.

Obs! API-versionerna 7.0 till 20.0 har redan tagits bort och gjorts otillgängliga i Summer ’22-utgåvan.

Varför drar vi tillbaka dessa API-versioner?
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. För att sätta saker i perspektiv: API-version 30 kom i vår Spring '14-utgåva.

Vad påverkar denna tillbakadragning av API-versioner?
Denna tillbakadragning påverkar kod, paket, applikation eller integration som utför en begäran av version 21.0 till 30.0 SOAP, REST eller Bulk API. 

Obs! Denna tillbakadragning påverkar inte följande:

• API-versionerna av Apex-klasser, Apex-utlösare, Visualforce-sidor, flöden eller processbyggare

• Den färdiga standardprodukten B2B Classic/Visualforce

• Senaste version av metadatakomponeter i ett hanterat paket

• Anpassade Apex REST & SOAP webbtjänster (En anpassad Apex-webbtjänst är ett sätt att göra en Apex-klassmetod anropbar som ett offentligt API. Du kan lära dig mer om Apex webbtjänster här: Apex webbtjänster) 

Vilka åtgärder behöver jag vidta?

1. Identifiera eventuella komponenter/appar i din organisation som använder dessa äldre API-versioner.

2. Uppdatera dessa komponenter/appar. Innan utgåvan Summer '25 måste du ändra eller uppgradera dina appar så att de fungerar med aktuella API-versioner som stöds. Salesforce rekommenderar starkt att flytta till nyare versioner av API:er eftersom de ger dig avancerade funktioner med förbättrad säkerhet och prestanda.

Se tabellen nedan för några vanliga platser för påverkan och vilka åtgärder som ska vidtas för var och en:

Hur vet jag om/var dessa äldre API-versioner används i mina appar?

Kontakta utvecklarna av de appar du använder för att fastställa API-versionerna.

Dessutom kan du granska API-händelser gratis i API Total Usage EventLogFile som rapporterar SOAP-, REST- och Bulk API-aktivitet från Salesforce med någon av följande två metoder.

1. Den första metoden är att använda den nya Händelseloggbläddraren som ingår i Summer '24-utgåvan.  Med detta kan du bläddra i API Total Usage-händelseloggfilerna på din organisation och ladda ner dem som CSV-filer för att se de individuella API-händelserna. 

Från Inställningar, navigera till Säkerhet → Händelseövervakning → Händelseloggbläddrare.  Här kan du se händelseloggfilerna för de senaste 24 timmarna (eller de senaste 30 dagarna om du har aktiverat Händelseövervakning).  Du kan sedan ladda ner enskilda händelseloggfiler som CSV-filer för att se API-händelserna i dem.

2. Alternativt är den andra metoden att använda en klient som Salesforce CLI för att köra en SOQL-fråga mot EventLogFile-objektet och tillhandahålla händelseloggfilerna för de senaste 24 timmarna (eller de senaste 30 dagarna om du har aktiverat Event Monitoring ).

sf data query -q "SELECT Id, LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('ApiTotalUsage')" -o <ditt-användarnamn>

För varje resultat, utför en REST API-begäran till slutpunkterna i frågereslutatet för att hämta händelseloggdatan i den händelseloggfilen*.

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

Klistra in svarets brödtext i en app för att 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 30 och tidigare.

Granska alla API Total Usage-händelser (ApiTotalUsage EventType) med API_VERSION av 30 och lägre**

4. För alla integrationer eller klienter som använder version 30.0 och lägre, följ tipsen från nyckelfälten i händelseloggdatan för att hjälpa till att identifiera källan till det äldre API-anropet:

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

För mer information om händelseövervakning, ta Trailhead-modulen Händelseövervakning.

*För introduktionsinformation om hur du utför en REST API-begäran, se denna Trailhead Använd REST API.

**Händelsetypen "Total användning av API" konsoliderar relevant begärd information i SOAP-, Bulk- och REST-API:erna, inklusive versionsinformation. Se händelsedefinitionsdetaljer här. API-aktiverade organisationer har fri tillgång till händelseloggfilerna om Total användning av API, med 1-dags datalagring. Med Händelseövervakning aktiverad, du kan komma åt denna och alla andra händelseloggfiltyper med 30 dagars datalagring.

Du kan också göra följande för att hitta Bulk API-förfrågningar eller SOAP API-inloggningar:

• Hitta Bulk API-förfrågningar: För Bulk API, gå till sidan “Data load-jobb i bunt” i Inställningar och se detaljerna för varje “Bulk V1”-jobb. Denna API-avveckling kommer att påverka alla jobb med ett värde på 30,0 eller lägre i fältet "API-version".

• Hitta SOAP API-inloggningar: För SOAP login()-operationen, navigera till "Inloggningshistorik" i Setup och granska posterna med "SOAP Enterprise" eller "SOAP Partner" som API-typ. Alternativt kan sökfrågor till LoginHistory sObject ställas via SOQL. Alla inloggningsposter som har ett värde på 30.0 eller lägre i fältet "API-version" kommer att påverkas av denna avveckling.

Obs! Partners kan utnyttja paketanvändningsloggarna för insikter om användning av föråldrade API:er.

Hur kan jag få mer information?

Om de senaste API-versionerna som stöds, besök Salesforce Developers-webbplatsen.

Om API:er och utgående meddelanden:

• Platform API-grunder (Trailhead)

• Introduktion till SOAP API (Developer Guide)

• Förstå utgående meddelanden (Developer Guide)

• Bulk API (Developer Guide)

• Introduktion till REST API (Developer Guide)

  • "REST" täcker alla API:er med slutpunkts-URI:er under /services/data/vXX.Y/ och /services/metadata/vXX.Y/ där XX.Y är API-versionen. Detta inkluderar "standard" Salesforce Platform REST API för att arbeta med sObjects och poster, men även följande resurser:

    • Metadata API Developer

    • Tooling API

    • Chatter/Connect API

    • Fråga och fråga alla API:er

    • Search API

    • Limits API

    • Login API (kallas även “Identitet”)

• • • Observera resultaten av en REST-begäran till GET /services/data/v30.0 eller GET /services/metadata/v30.0 för att förstå vilka resurser på toppnivå som påverkas när v30.0 och lägre slutpunkter tas bort.

Om du vill ha mer information om denna äldre API-avveckling kan du se En viktig uppdatering av vår plan att dra tillbaka äldre API.

För en förklaring av API-versioner riktade till administratörer, lyssna på podden här (den är några år gammal, men kärninformationen är fortfarande relevant): Varför API-versioner är viktiga med Kris Harrison.

Jag behöver fortfarande hjälp. Vad kan jag göra nu?

• Gå igenom resurserna ovan.

• Gör ett inlägg i Trailblazer Community.

• Skapa ett kundcase med Salesforce Support via Salesforce-hjälpen. Kom ihåg vad du redan har provat och var du har fastnat så att supporten kan hjälpa dig så effektivt som möjligt. **Observera att support inte kan uppdatera de äldre API:erna i din organisation.

Du kan se alla nuvarande och kommande tillbakadraganden i Tillbakadraganden av Salesforce produkter och funktioner. Mer information om Salesforces tillbakadragande av produkter och funktioner finns i vår Filosofi för tillbakadragande av funktioner.