Intrekking Salesforce Platform, API-versie 21.0 t/m 30.0

Oorspronkelijke publicatiedatum: 20 oktober 2020

Voor het laatst bijgewerkt op 4 mei 2024
 

Wat is de status van de versies 21-30 van de SOAP-, REST- en Bulk-API?

• Actueel: Deze API-versies zijn afgekeurd (sinds de Summer '22-release) en worden niet langer ondersteund. U kunt ze wel gebruiken, maar indien u problemen tegenkomt en een case opent voor de ondersteuning van Salesforce, moet u eerst de API-versie bijwerken. Er zijn geen probleemoplossingen of bugfixes voor deze verouderde API-versies.

• Toekomst: Summer '25-release: De certificering van deze API-versies wordt ingetrokken. Toepassingen die deze versies gebruiken, worden verstoord, omdat oproepen mislukken en reageren met een fout dat het aangevraagde eindpunt niet is gevonden en ze niet kunnen worden verwerkt door het platform. Hieronder staan de fouten:

  • REST-API retourneert 410: GONE.

  • SOAP-API retourneert 500: UNSUPPORTED_API_VERSION.

  • Bulk-API retourneert 400: InvalidVersion.

Opmerking: De certificering van de API-versies 7.0 tot en met 20.0 is al ingetrokken. Deze versies zijn niet meer beschikbaar vanaf de Summer '22-release.

Waarom wordt de certificering van deze API-versies ingetrokken?
We richten onze ontwikkelingsinspanningen op het verbeteren van de nieuwste API-versies om zodoende de algemene Salesforce-omgeving te verbeteren bij het samenstellen van aangepaste functionaliteit via toepassingen. Ter indicatie: de API-versie 30 komt uit onze Spring '14-release.

Waarop heeft het intrekken van de certificering van deze API-versies invloed?
Deze intrekking heeft invloed op alle codes, pakketten, toepassingen en integraties die een verzoek uitvoeren van de versies 21.0 tot en met 30.0 van de SOAP-, REST- en Bulk-API.

Opmerking: Deze intrekking heeft geen invloed op het volgende:

• De API-versies van Apex-klassen, Apex-triggers, Visualforce-pagina's, stromen en processamenstellers

• Het kant-en-klare B2B Classic-/Visualforce-product

• Geversioneerde metagegevenscomponenten in een beheerd pakket

• Aangepaste Apex REST- en SOAP-webservices (een aangepaste Apex-webservice is een manier om een Apex-klassemethode aanroepbaar te maken als een openbare API. U vindt hier meer informatie over Apex-webservices: Apex-webservices) 

Welke acties moet ik ondernemen?

1. Identificeer alle componenten/toepassingen in uw organisatie die gebruikmaken van deze verouderde API-versies.

2. Werk die componenten/toepassingen bij. Vóór de Summer '25-release moet u uw toepassingen aanpassen of bijwerken, zodat deze functioneren met de huidige en ondersteunde API-versies. Salesforce raadt sterk aan om over te stappen op nieuwere versies van API's, aangezien deze geavanceerde mogelijkheden bieden met verbeterde beveiliging en prestaties.

Bekijk de tabel hieronder voor veelvoorkomende componenten die worden beïnvloed en welke acties u voor elk kunt ondernemen:

Hoe weet ik of/waar verouderde API-versies in mijn toepassingen worden gebruikt?

Neem contact op met de ontwikkelaars van de toepassingen om de API-versies te bepalen.

Daarnaast kunt u API-functies beoordelen met het gratis Functielogbestand voor het totale API-gebruik dat SOAP-, REST-, en Bulk-API-activiteit van Salesforce rapporteert op een van de volgende twee methoden.

1. De eerste methode is om de nieuwe functielog-browser te gebruiken die in de Summer '24-release zit inbegrepen.  Hiermee kunt u zoeken op functielogbestanden over het totale API-gebruik van uw organisatie. U kunt deze downloaden als CSV-bestanden om de individuele API-functies te bekijken.

Ga vanuit Set-up naar Beveiliging → Event Monitoring → Functielog-browser.  Hier kunt u de functielogbestanden bekijken van de afgelopen 24 uur (of de afgelopen dagen als u Event Monitoring hebt ingeschakeld).  U kunt vervolgens individuele functielogbestanden downloaden als CSV-bestanden om de bijbehorende API-functies te bekijken.

2. De tweede methode omvat het gebruik van een cliënt, zoals de Salesforce CLI, voor de uitvoering van een SOQL-zoekopdracht op het object EventLogFile, waardoor u de functielogbestanden krijgt van alle API-acties van de afgelopen 24 uur (of afgelopen 30 dagen, als u Event Monitoring hebt geactiveerd).

sf data query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -o <uw-gebruikersnaam>

Voer voor elk resultaat een REST API-verzoek met behulp van de endpoints uit in het zoekopdrachtresultaat om de functieloggegevens op te halen van dat logbestand*.

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

Plak het responsbericht in een toepassing, zodat u de functieloggegevens gemakkelijker kunt bekijken als een .CSV-bestand.

3. Bekijk elk .CSV-bestand en bepaal of er verzoeken zijn gedaan aan eindpunten met API-versies 30 en lager.

Bekijk alle functies voor het totale API-gebruik (Totaal API-gebruik/ ApiTotalUsage EventType) met API_VERSION van 30 en lager**

4. Voor integraties of cliënten die versie 30 en lager gebruiken, volgt u de hints die de belangrijke velden in de functieloggegevens leveren om de bron van de verouderde API-oproep te identificeren:

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

Bekijk voor meer informatie over Event Monitoring de Trailhead-module voor Event Monitoring.

*Bekijk voor beginnersinformatie over het uitvoeren van een REST-API-verzoek deze trailhead REST-API gebruiken.

***Het eventtype Totaal verbruik van API combineert relevante informatie over verzoeken binnen de SOAP-, bulk- en REST-API's, waaronder versiegegevens. De details over de eventdefinitie vindt u hier. Organisaties met ingeschakelde API's hebben gratis toegang tot de eventlogboekbestanden van totaal API-verbruik met een bewaarperiode van 1 dag. Als Event Monitoring is ingeschakeld, hebt u toegang tot dit alles en alle andere soorten functielogbestanden met een bewaarperiode van 30 dagen.

U kunt ook het volgende doen om Bulk-API-verzoeken of SOAP-API-logins te vinden:

• Bulk-API-verzoeken zoeken: Ga voor de Bulk-API naar de pagina Taken voor het in bulk laden van gegevens binnen Set-up en bekijk de details van elke Bulk V1-taak. Deze API-intrekking heeft invloed op alle taken met een waarde van 30.0 of lager binnen het veld API-versie.

• SOAP-API-logins zoeken: Voor de SOAP -inlogbewerking, gaat u naar Inloghistorie binnen Set-up en bekijkt u de entry's met SOAP Enterprise of SOAP Partner als het type API. Als alternatief kan via SOQL een zoekopdracht worden uitgevoerd op LoginHistory sObject . Elke inlog-entry die een waarde van 30.0 of lager bevat in het veld API-versie, wordt beïnvloed door deze-intrekking.

Opmerking: Partners kunnen gebruikmaken van het Pakket met gebruiklogs voor inzichten in het gebruik van hun afgekeurde API's.

Hoe kan ik meer informatie krijgen?

Bezoek de Salesforce-ontwikkelaarssite voor informatie over de nieuwste ondersteunde API-versies.

Over API's en uitgaand berichtenverkeer:

• Platform API Basics (Trailhead)

• Introduction to SOAP API (Introductie in SOAP-API, ontwikkelaarsgids)

• Understanding Outbound Messaging (Inzicht in uitgaand berichtenverkeer, ontwikkelaarsgids)

• Bulk API (Bulk-API, ontwikkelaarsgids)

• Introduction to REST API (Inleiding in REST-API, ontwikkelaarsgids)

  • 'REST' omvat alle API’s met endpoint-URI's onder /services/data/vXX.Y/ en /services/metadata/vXX.Y/ waarbij XX.Y de API-versie is. Dit omvat de 'standaard' REST-API van het Salesforce-platform om met sObjects en records te werken, maar ook de volgende resources:

    • Metadata API Developer

    • Tooling-API

    • Chatter/Connect API

    • Query en Query Alle API's

    • API doorzoeken

    • Limits API

    • Login API (aka 'Identity')

• • • Bekijk de resultaten van een REST-verzoek aan GET /services/data/v30.0 of GET /services/metadata/v30.0 om inzicht te krijgen in hoogstaande resources die worden getroffen wanneer de certificeringen van endpoints van v30.0 en lager worden ingetrokken.

Bekijk Een belangrijke update voor ons plan voor het intrekken van de certificering van verouderde API's als u meer informatie wilt over de intrekking van de certificering van verouderde API's.

Voor een uitleg over API-versies die is gericht op beheerders, kunt u naar deze podcast luisteren (deze is een paar jaar oud, maar de kerninformatie is nog steeds relevant): Why API Versions Matter with Kris Harrison(waarom API-versies belangrijk zijn, met Kris Harrison).

Ik heb nog steeds hulp nodig. Wat kan ik nu doen?

• Lees de bronnen hierboven.

• Plaats een bericht in de Trailblazer-community.

• Open een case bij de ondersteuning van Salesforce via Salesforce Help. Onthoud goed welke oplossing u al hebt geprobeerd en waar u precies problemen mee ondervindt, zodat het ondersteuningsteam u zo goed mogelijk kan helpen. **Houd in gedachten dat het ondersteuningsteam de verouderde API's in uw organisatie niet kan bijwerken.

Ga voor alle actuele en eerdere intrekkingen van certificeringen naar Intrekkingen van certificeringen van Salesforce-producten en -voorzieningen. Voor meer informatie over de aanpak van Salesforce bij het intrekken van certificeringen van producten en voorzieningen, leest u onze Filosofie ten aanzien van het intrekken van de certificeringen van producten en voorzieningen.