Tilbagetrækning af Salesforce Platform API-versionerne 21.0 til 30.0

Oprindelig udgivelsesdato - 20. oktober 2020

Opdateret - 4. maj 2024
 

Hvad er statussen på SOAP-, REST- og Bulk API-versionerne 21-30?

• Aktuelt: Disse API-versioner er udfaset (pr. Summer ‘22-versionen) og understøttes ikke længere. Du kan bruge dem, men hvis du oplever problemer og opretter en sag hos Salesforce Support, skal du først opdatere API-versionen. Der vil ikke være nogen fejlfinding eller fejlrettelser for disse ældre API-versioner.

• Fremadrettet: Summer ‘25-versionen – Disse API-versioner vil blive trukket tilbage. Applikationer, der bruger versionerne, vil blive afbrudt, fordi kald mislykkes og besvares med en fejl om, at det ønskede slutpunkt ikke blev fundet og ikke kan behandles af platformen. Nedenfor vises fejlene:

  • REST API returnerer 410: GONE.

  • SOAP API returnerer 500: UNSUPPORTED_API_VERSION.

  • Bulk API returnerer 400: InvalidVersion.

Bemærk! API-versionerne 7.0 til 20.0 blev trukket tilbage og blev gjort utilgængelige fra og med Summer ’22-versionen.

Hvorfor trækker vi disse API-versioner tilbage?
Vi koncentrerer vores udviklingsindsats om forbedring af vores nyeste API-versioner for at forbedre den generelle Salesforce-oplevelse ved opbygning af tilpasset funktionalitet via applikationer. For at sætte tingene i perspektiv: API version 30 er fra vores Spring ‘14-version.

Hvad påvirker denne tilbagetrækning af API-versioner?
Denne tilbagetrækning påvirker enhver kode, pakke, applikation eller integration, der kører en anmodning af versionerne 21.0 til 30.0 af SOAP-, REST- eller Bulk-API.

Bemærk: Denne tilbagetrækning vil ikke påvirke følgende:

• API-versionerne af Apex-klasser, Apex-udløsere, Visualforce-sider, forløb og proceskonstruktører

• Det køreklare B2B Classic/Visualforce-produkt

• Versionerede metadatakomponenter i en administreret pakke

• Tilpasset Apex REST og SOAP Web Services (en tilpasset Apex-webtjeneste er en måde til at få en Apex-klassemetode til at kunne kaldes som en offentlig API. Du kan få mere at vide om Apex Web Services her: Apex Web Services) 

Hvilke handlinger skal jeg udføre?

1. Identificer eventuelle komponenter/applikationer i din organisation, der bruger disse ældre API-versioner.

2. Opdater disse komponenter/applikationer. Før Summer '25-versionen skal du redigere eller opgradere dine applikationer til at fungere med aktuelle, understøttede API-versioner. Salesforce anbefaler kraftigt, at du flytter til nyere versioner af API'er, da de giver dig avancerede funktioner med forbedret sikkerhed og ydeevne.

Se tabellen nedenfor for at se nogle af de almindelige steder, der påvirkes, og hvilke handlinger der skal udføres for hvert:

Hvordan ved jeg, om/hvor disse ældre API-versioner bruges i mine applikationer?

Kontakt udviklerne af de applikationer, du anvender, for at finde ud af, hvilke API-versioner, der anvendes.

Du kan desuden gennemse API-begivenheder i den gratis API Total Usage EventLogFile, som rapporterer SOAP-, REST- og Bulk API-aktivitet fra Salesforce ved brug af følgende to metoder.

1. Den første metode er at bruge den nye Event Log Browser, der er inkluderet i Summer ‘24-versionen.  Du kan bruge denne til at gennemse begivenhedslogfiler for API-anvendelse i alt i din organisation og downloade dem som CSV-filer for at se de individuelle API-begivenheder.

Vælg Opsætning, gå til Sikkerhed → Begivenhedsovervågning → Event Log Browser.  Her kan du se begivenhedslogfilerne for de seneste 24 timer (eller de sidste 30 dage, hvis du har aktiveret Begivenhedsovervågning).  Du kan derefter downloade individuelle begivenhedslogfiler som CSV-filer for at se API-begivenhederne i dem.

2. Den anden metode er at bruge en klient som f.eks. Salesforce CLI til at køre en SOQL-forespørgsel op mod EventLogFile-objektet, så du får begivenhedslogfiler for de sidste 24 timer (eller de sidste 30 dage, hvis du har aktiveret Begivenhedsovervågning).

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

For hvert resultatet skal du foretage en REST API-anmodning til slutpunkterne i forespørgselsresultatet for at hente begivenhedslogdataene i denne begivenhedslogfil.*

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

Indsæt svarbrødteksten i en applikation, så du nemt kan inspicere begivenhedslogdataene som en .CSV-fil.

3. Gennemse hver .CSV-fil, og find ud af, om der sendes anmodninger til slutpunkter med API-version 30 og lavere.

Gennemse alle begivenheder for API-anvendelse i alt (ApiTotalUsage EventType) med API_VERSION 30 og derunder**

4. For integrationer eller klienter, der anvender version 30.0 og derunder, skal du følge de tips, der er angivet af nøglefelter i begivenhedslogsdataene for at hjælpe med at identificere kilden i det forældede API-kald:

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

Hvis du ønsker yderligere oplysninger om Begivenhedsovervågning, kan du tage Event Monitoring Trailhead-modulet.

*Hvis du ønsker introduktionsoplysninger om, hvordan du udfører en REST API-anmodning, kan du se trailhead Brug REST API.

**Begivenhedstypen "API-anvendelse i alt" konsoliderer relevante forespørgselsoplysninger på tværs af SOAP-, Bulk- og REST-API'er, inklusive versionsoplysninger. Se detaljer for begivenhedsdefinition her. API-aktiverede organisationer har gratis adgang til begivenhedslogfilernes API-anvendelse i alt med 1 dags dataopbevaring. Med Begivenhedsovervågning aktiveret kan du få adgang til dette og alle andre begivenhedslogfiltyper med 30-dages dataopbevaring.

Du kan også gøre følgende for at finde Bulk API-anmodninger eller SOAP API-logins:

• Find Bulk API-anmodninger: For Bulk API skal du navigere til siden "Massedataindlæsningsjob" i Opsætning og se detaljerne for hvert "Bulk V1"-job. Denne API-tilbagetrækning vil påvirke ethvert job med en værdi på 30.0 eller derunder med "API Version"-feltet.

• Find SOAP API-logins: For SOAP login()-handlingen skal du navigere til "Loginhistorik" i Opsætning og gennemse oplysningerne med "SOAP Enterprise" eller "SOAP Partner" som API-type. Alternativt kan LoginHistory sObject blive forespurgt via SOQL. Enhver loginoplysning med værdien 30.0 eller derunder i feltet "API Version" vil være påvirket af denne tilbagetrækning.

Bemærk! Partners kan anvende pakkeanvendelseslogfilerne til at få indsigt i forbruget af deres udfasede API.

Hvordan får jeg flere oplysninger?

Oplysninger om de nyeste understøttede API-versioner finder du på Salesforce Developers-lokaliteten.

Om API'er og udgående meddelelser:

• Grundlæggende om Platform-API (Trailhead)

• Introduktion til SOAP-API (Developer Guide)

• Understanding Outbound Messaging (Developer Guide)

• Bulk API (Developer Guide)

• Introduction to REST API (Developer Guide)

  • "REST" dækker alle API'er med slutpunkts-URI'er under /services/data/vXX.Y/ og /services/metadata/vXX.Y/, hvor XX.Y er API-versionen. Dette omfatter "standard" Salesforce Platform REST API til at arbejde med sObjects og registreringer, men også følgende ressourcer:

    • Metadata API Developer

    • Tooling-API

    • Chatter/Connect-API

    • Query and Query All-API'er

    • Search-API

    • Limits-API

    • Login-API (også kaldet "Identity”)

• • • Vær opmærksom på resultaterne af en REST-anmodning til GET /services/data/v30.0 eller GET /services/metadata/v30.0 for at forstå, hvilke ressourcer på topniveau, der vil blive påvirket, når v30.0 og lavere slutpunkter trækkes tilbage.

Hvis du ønsker yderligere oplysninger om tilbagetrækning af disse forældede API'er, kan du se An Important Update to Our Legacy API Retirement Plan (En vigtig opdatering til vores plan om tilbagetrækning af forældede API'er).

Hvis du ønsker en forklaring på, hvilke API-versioner, der er rettet mod administratorer, kan du lytte til podcast'en her (den er nogle få år gammel, men kerneoplysningerne er stadig relevante): Why API Versions Matter with Kris Harrison (Hvorfor API-versioner betyder noget med Kris Harrison).

Jeg har stadig brug for hjælp. Hvad kan jeg gøre derefter?

• Gennemgå ressourcerne ovenfor.

• Slå indlæg op i Trailblazer Community.

• Opret en sag hos Salesforce Support via Hjælp til Salesforce. Husk, hvad at du allerede har forsøgt, og hvor du er gået i stå, så Support kan hjælpe dig så effektivt som muligt. ****Bemærk, at Support ikke kan opdatere de ældre API'er i din organisation.

Hvis du vil se alle aktuelle og tidligere tilbagetrækninger, kan du se Salesforce-produkt- og funktionstilbagetrækninger. Hvis du ønsker yderligere oplysninger om Salesforces tilgang til tilbagetrækning af produkter og funktioner, kan du læse vores Filosofi for produkt og funktionstilbagetrækning.