Avvikling av Salesforce Platform API-versjon 21.0 til og med 30.0

Opprinnelig publiseringsdato – 20. oktober 2020

Oppdatert – 4. mai 2024
 

Hva er status for SOAP-, REST- og Bulk API-versjon 21–30?

• Nåværende: Disse API-versjonene er foreldet (per Summer ‘22-utgivelsen) og støttes ikke lenger. Du kan bruke dem, men hvis du støter på problemer og logger en sak hos Salesforce Kundestøtte, må du først oppdatere API-versjonen. Det vil ikke bli noen feilsøking eller feilrettelser for disse eldre API-versjonene.

• Fremtidig: Summer ‘25-utgivelsen – Disse API-versjonene vil bli avviklet. Apper som bruker versjonene vil bli avbrutt fordi oppkall mislykkes og svarer med en feil om at det forespurte endepunktet ikke ble funnet og ikke kan behandles av plattformen. Nedenfor er feilene:

  • REST API returnerer 410: GONE.

  • SOAP API returnerer 500: UNSUPPORTED_API_VERSION.

  • Bulk API returnerer 400: InvalidVersion.

Merk: API-versjon 7.0 til og med 20.0 ble avviklet og gjort utilgjengelig i Summer ’22-utgivelsen.

Hvorfor avvikler vi disse API-versjonene?
Vi konsentrerer utviklingsarbeidet vårt om å forbedre de nyeste API-versjonene for å forbedre totalopplevelsen av Salesforce når det lages tilpasset funksjonalitet via programmer. For å sette ting i perspektiv – API-versjon 30 var fra Spring ‘14-utgivelsen.

Hva påvirkes av denne avviklingen av API-versjoner?
Denne avviklingen påvirker kode, pakker, apper eller integrasjoner som utfører en forespørsel om versjon 21.0 til og med 30.0 av SOAP, REST eller Bulk API.

Merk: Denne avviklingen vil ikke påvirke følgende:

• API-versjonene av Apex-klasser, Apex-utløsere, Visualforce-sider, flyter og prosessbyggere

• Det ferdige B2B Classic/Visualforce-produktet

• Versjonerte metadatakomponenter i en administrert pakke

• Tilpassede Apex REST- og SOAP Web Services (En tilpasset Apex Web Service er en måte å gjøre en Apex-klassemetode oppkallbar som et offentlig API på. Du finner mer informasjon om Apex Web Services her: Apex Web Services)

Hva må jeg gjøre?

1. Identifiser alle komponenter/apper i organisasjonen som bruker disse eldre API-versjonene.

2. Oppdater de komponentene/appene. Før Summer '25-utgivelsen må du endre eller oppgradere appene slik at de fungerer med gjeldende og støttede API-versjoner. Salesforce anbefaler på det sterkeste at du flytter til nyere versjoner av API-er siden de gir deg avansert funksjonalitet med forbedret sikkerhet og ytelse.

Se tabellen nedenfor for å finne vanlige steder for påvirkning og hvilke handlinger som kan gjøres for hvert:

Hvordan vet jeg om/hvor disse eldre API-versjonene brukes i appene mine?

Kontakt utviklerne av programmene du bruker, for å finne API-versjon.

Du kan dessuten se gjennom API-hendelser i den gratis EventLogFile for total API-bruk som rapporterer SOAP-, REST- og Bulk API-aktivitet fra Salesforce på en av disse to måtene.

1. Den første metoden er å bruke den nye Event Log Browser som er inkludert i Summer ‘24-utgivelsen.  Med den kan du bla gjennom hendelsesloggfiler for total API-bruk i organisasjonen, og laste dem ned som CSV-filer for å se de individuelle API-hendelsene.

Gå til Sikkerhet → Hendelsesovervåking → Event Log Browser i Oppsett.  Her kan du se hendelsesloggfilene for de siste 24 timene (eller de siste 30 dagene hvis du har aktivert Hendelsesovervåking).  Deretter kan du laste ned individuelle hendelsesloggfiler som CSV-filer for å se API-hendelsene i dem.

2. Den andre metoden er å bruke en klient som Salesforce CLI til å kjøre en SOQL-spørring mot EventLogFile-objektet for å få hendelsesloggfiler for de siste 24 timene (eller de siste 30 dagene hvis du har aktivert Hendelsesovervåking).

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

For hvert resultat utfører du en REST API-forespørsel til endepunktene i spørringsresultatet for å hente hendelsesloggdataene i den hendelsesloggfilen*.

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

Lim inn svarteksten i et program for lettere å kunne undersøke dataene 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-versjon 30 og lavere.

Se gjennom alle hendelser for total API-bruk ( ApiTotalUsage EventType) med API_VERSION 30 og lavere**

4. For integrasjoner eller klienter som bruker versjon 30.0 og lavere bruker du hintene i nøkkelfeltene i hendelsesloggdataene som hjelp til å identifisere kilden til det eldre API-oppkallet:

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

Hvis du vil ha mer informasjon om hendelsesovervåking, kan du ta Trailhead-modulen Event Monitoring.

*Innføring i hvordan du utfører en REST API-forespørsel finnes i Trailhead Use REST API.

**Hendelsestypen “Total API-bruk” konsoliderer relevant forespørselsinformasjon på tvers av SOAP, Bulk og REST API-er, inkludert versjonsinformasjon. Se detaljer om hendelsesdefinisjon her. API-aktiverte organisasjoner har fri tilgang til hendelsesloggfilene for Total API-bruk, med dataoppbevaring i 1 dag. Med Hendelsesovervåking aktivert får du tilgang til denne og alle andre typer hendelsesloggfiler med 30 dagers dataoppbevaring.

Du kan også gjøre følgende for å finne Bulk API-forespørsler eller SOAP API-pålogginger:

• Finne Bulk API-forespørsler: Når det gjelder Bulk API, går du til siden Massedatalastingsjobber under Oppsett og ser på detaljene for hver Masse V1-jobb. Denne API-avviklingen vil påvirke alle jobber med en verdi på 30.0 eller lavere i feltet API-versjon.

• Finne SOAP API-pålogginger: For SOAP login()-operasjonen går du til Påloggingshistorikk under Oppsett og gjennomgår oppføringene med SOAP Enterprise eller SOAP Partner som API-type. Alternativt kan LoginHistory sObject spørres via SOQL. En påloggingsoppføring som har verdien 30.0 eller lavere i feltet API-versjon, vil bli berørt av denne avviklingen.

Merk: Partnere kan benytte loggene over pakkebruk til å få innsikt i forbruk av foreldet API.

Hvor finner jeg mer informasjon?

Du finner informasjon om de nyeste API-versjonene som støttes, på Salesforce Developers-nettstedet.

Om API-er og utgående meldinger:

• Grunnleggende om Platform API (Trailhead)

• Introduksjon til SOAP API (utviklerveiledning)

• Forstå utgående meldinger (utviklerveiledning)

• Bulk API (utviklerveiledning)

• Introduksjon til REST API (utviklerveiledning)

  • “REST” dekker alle API-er med endepunkt URI-er under /services/data/vXX.Y/ og /services/metadata/vXX.Y/ der XX.Y er API-versjonen. Dette inkluderer “standard” Salesforce Platform REST API for arbeid med sObjects og poster, men også følgende ressurser:

    • Metadata API Developer

    • Tooling API

    • Chatter/Connect API

    • Query and Query All API-er

    • Search API

    • Limits API

    • Login API (aka “Identity”)

• • • Se på resultatene fra en REST-forespørsel til GET /services/data/v30.0 eller GET /services/metadata/v30.0 for å forstå settet med ressurser på øverste nivå som berøres når v30.0 og lavere endepunkter avvikles.

Hvis du vil ha mer informasjon om denne avviklingen av eldre API-er, kan du se En viktig oppdatering til planen om avvikling av eldre API-er.

Hvis du ønsker en forklaring av API-versjoner rettet mot administratorer, kan du høre på denne podcasten (den er noen år gammel, men kjerneinformasjonen er fremdeles relevant): Why API Versions Matter with Kris Harrison.

Jeg trenger fremdeles hjelp. Hva kan jeg gjøre nå?

• Gå gjennom ressursene ovenfor.

• Lag et innlegg i Trailblazer Community.

• Opprett en sak hos Salesforces kundestøtte via Salesforce Hjelp. Merk deg det du allerede har forsøkt og hvor du blir sittende fast, slik at kundestøtte kan hjelpe deg så effektivt som mulig. **Vær oppmerksom på at kundestøtte ikke kan oppdatere de eldre API-ene i organisasjonen din.

Se Avviklinger av Salesforce-produkter og -funksjoner for å se alle nåværende og tidligere avviklinger. Hvis du vil lese om Salesforces tilnærming til avvikling av produkter og funksjoner, kan du lese Filosofi for produkt- og funksjonsopphør.