Einstellung der Salesforce Platform-API-Versionen 31.0 bis 40.0

Aktualisiert am 30. April 2026

Ursprüngliches Veröffentlichungsdatum – 30. April 2026

Wie lautet der Status der SOAP-, REST- und Bulk-API-Versionen 31.0–40.0?

• Aktuell: Diese API-Versionen werden derzeit unterstützt.

• Künftig: Version Summer '27 – Diese API-Versionen werden als veraltet markiert und nicht weiter unterstützt. Sie können sie zwar verwenden, aber wenn Probleme auftreten und Sie einen Kundenvorgang beim Salesforce-Support erstellen, müssen Sie zunächst die API-Version aktualisieren. Für diese API-Versionen gibt es keine Fehlerbehebungen mehr.

• Künftig: Version Summer '28 – Diese API-Versionen werden eingestellt und aus der Plattform entfernt. Bei Anwendungen, die diese Versionen verwenden, kommt es zu Unterbrechungen, da die API-Aufrufe fehlschlagen mit dem Fehler, dass der angeforderte Endpunkt nicht gefunden wurde und die Anforderung von der Plattform nicht verarbeitet werden kann. Im Folgenden sind die Fehler aufgeführt:

  • Die REST-API gibt Folgendes zurück :410: GONE.

  • Die SOAP-API gibt Folgendes zurück: 500: UNSUPPORTED_API_VERSION zurück.

  • Die Bulk-API gibt Folgendes zurück: 400: InvalidVersion.

Hinweis: Die API-Versionen 21.0 bis 30.0 wurden bereits eingestellt und sind in der Version Summer '25 nicht mehr verfügbar.

Warum stellt Salesforce diese API-Versionen ein?

Wir konzentrieren unsere Entwicklungsbemühungen auf die Verbesserung der neuesten API-Versionen, um die gesamte Salesforce-Erfahrung beim Erstellen benutzerdefinierter Funktionen über Anwendungen zu verbessern. Zur Einordnung: API-Version 31.0 stammt aus der Version Spring '14.

Welche Auswirkungen hat die Einstellung dieser API-Version?

Diese Einstellung betrifft jeglichen Code, alle Pakete, Anwendungen oder Integrationen, die Anforderungen der Versionen 31.0 bis 40.0 der SOAP-, REST- oder Bulk-API ausführen.

Hinweis: Diese Einstellung wirkt sich nicht auf Folgendes aus:

• Die API-Versionen von Apex-Klassen, Apex-Auslösern, Visualforce-Seiten, Flows und Prozessgeneratoren

• Das vorkonfigurierte B2B Classic-/Visualforce-Produkt

• Versionierte Metadatenkomponenten in einem verwalteten Paket

• Benutzerdefinierte Apex-REST- und -SOAP-Webservices (ein benutzerdefinierter Apex-Webservice bietet die Möglichkeit, eine Apex-Klassenmethode als öffentliche API aufrufbar zu machen. Hier erhalten Sie weitere Informationen zu Apex-Webservices: Apex-Webservices)

Welche Maßnahmen müssen ergriffen werden?

1. Ermitteln Sie alle Komponenten/Anwendungen in Ihrer Organisation, die diese alten API-Versionen verwenden.

2. Aktualisieren Sie diese Komponenten/Anwendungen. Vor Einführung der Version Summer '28 müssen Sie Ihre Anwendungen aktualisieren, sodass sie mit aktuellen, unterstützten API-Versionen funktionieren. Salesforce empfiehlt dringend, auf neuere Versionen der APIs umzustellen, da diese erweiterte Funktionen, mehr Sicherheit und eine bessere Leistung bieten.

In der unten stehenden Tabelle finden Sie Stellen, die häufig betroffen sind, sowie die jeweils erforderlichen Aktionen:

Wie kann ich feststellen, ob und wo diese alten API-Versionen in meinen Anwendungen verwendet werden?

Wenden Sie sich an die Entwickler der von Ihnen verwendeten Anwendungen, um die API-Versionen zu bestimmen.

Die API-Ereignisse können Sie im kostenlosen API Total Usage EventLogFile überprüfen. Dieses berichtet über Aktivitäten der SOAP-, REST- und Bulk-API. Der Ereignistyp "Gesamte API-Nutzung" konsolidiert API-Anforderungsinformationen übergreifend für die SOAP-, Bulk- und REST-APIs, einschließlich der Versionsinformationen.

API-fähige Organisationen verfügen über Zugriff auf die Protokolldateien der vorherigen 24 Stunden des Ereignisses "Gesamte API-Nutzung".

Organisationen mit aktivierter Ereignisüberwachung verfügen über Zugriff hieraus und auf alle weiteren Typen von Ereignisprotokolldateien mit einer Datenaufbewahrung von 30 Tagen (diese kann über die Einstellungen der Ereignisüberwachung oder über die Metadaten-API "EventSettings" auf bis zu ein Jahr erhöht werden). Weitere Informationen zur Ereignisüberwachung erhalten Sie im Trailhead-Modul Ereignisüberwachung.

Wenn Sie diese Ereignisse zur gesamten API-Nutzung überprüfen möchten, müssen Sie sie zunächst mithilfe einer der drei unten beschriebenen Methoden als CSV-Dateien herunterladen.

1. Die erste Methode besteht darin, den neuen Ereignisprotokolldatei-Browser zu verwenden, der in der Version Summer '24 enthalten ist. Damit können Sie die Ereignisprotokolldateien zur gesamten API-Nutzung in Ihrer Organisation durchsuchen und sie als CSV-Dateien herunterladen, um die einzelnen API-Ereignisse anzuzeigen.

Navigieren Sie in "Setup" zu "Sicherheit" → "Ereignisüberwachung" → "Ereignisprotokolldatei-Browser". Dort können Sie die Ereignisprotokolldateien der letzten 24 Stunden (oder der letzten 30 Tage, wenn Sie die Ereignisüberwachung aktiviert haben) anzeigen. Sie können dann einzelne Ereignisprotokolldateien als CSV-Dateien herunterladen, um die API-Ereignisse darin anzuzeigen.

2. Bei der zweiten Methode wird das von Salesforce bereitgestellte Tool verwendet, um den Download der Daten für die gesamte API-Nutzung auf täglicher Basis zu automatisieren, damit die Daten der letzten 24 Stunden abgerufen werden. Dabei handelt es sich um ein Python-Skript, das die Daten im Objekt "EventLogFile" für die gesamte API-Nutzung extrahiert und sie in CSV-Dateien herunterlädt. Das Python-Skript verwendet die Salesforce CLI zum Authentifizieren und Abrufen von Daten.

3. Die dritte Methode besteht darin, manuell einen Client wie Salesforce CLI zu verwenden, um eine SOQL-Abfrage für das Objekt "EventLogFile" auszuführen, mit der die Ereignisprotokolldateien der letzten 24 Stunden (oder der letzten 30 Tage*, wenn Sie die Ereignisüberwachung aktiviert haben) bereitgestellt werden.

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

Führen Sie für jedes Ergebnis eine REST-API-Anforderung mit den Endpunkten im Abfrageergebnis aus, um die Ereignisprotokolldaten in dieser Ereignisprotokolldatei abzurufen*.

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

Fügen Sie den Antworttext in eine Anwendung ein, um die Ereignisprotokolldaten einfach als CSV-Datei zu untersuchen.

* Einführende Informationen zum Ausführen einer REST-API-Anforderung finden Sie in Trailhead unter Verwenden der REST-API.

Wenn die API-Ereignisse im EventLogFile zur gesamten API-Nutzung als CSV-Dateien heruntergeladen wurden, müssen Sie in jeder CSV-Datei nach allen Anfragen finden bei denen API_VERSION gleich oder weniger als 40 ist.

Befolgen Sie bei API-Versionen 40.0 und niedriger die Tipps, die in den folgenden Schlüsselfeldern in den Ereignisprotokolldaten angegeben sind, um die Quelle des Aufrufs einer API zu identifizieren:

• CONNECTED_APP_ID and CONNECTED_APP_NAME gibt die verbundene Anwendung oder externe Clientanwendung an, von der der API-Aufruf stammt.

  • A CONNECTED_APP_ID, die mit "0H4" beginnt, gibt eine verbundene Anwendung an.

  • A CONNECTED_APP_ID, die mit "0xI" beginnt, gibt eine externe Clientanwendung an.

• CLIENT_NAME ist eine optionale Kopfziele, die von Clients bereitgestellt wird, um die Zuordnung der Anwendungen zu den API-Aufrufen zu erleichtern.

• USER_NAME gibt den Benutzer in Ihrer Organisation an, der für die Authentifizierung der API-Aufrufe verwendet wird. Dies kann die Identifizierung des Ursprungs-Clients unterstützen. Beachten Sie aber, das das Systembenutzerkonto von mehreren Clients verwendet werden kann.

• CLIENT_IP ist die IP-Adresse des anfordernden Clients. Seien Sie aber vorsichtig, wenn mehrere Clients vom selben physischen Standort die gleiche IP-Adresse teilen.

Partner können die Paketnutzungsprotokolle für Statistiken zur Nutzung Ihrer ersetzten APIs verwenden.

Wie finde ich die Stellen in meinem Code, an denen alte API-Versionen verwendet werden?

Mit dem Salesforce Code Analyzer können Sie veraltete API-Versionen in Ihrem Code finden. Siehe diese Dokumentation.

Salesforce for Outlook

API, die von Salesforce for Outlook ausgehen, weisen den CLIENT_NAME "SfdcApplication/" im EventLogFile zur gesamten API-Nutzung auf. Nehmen Sie ein Upgrade auf die aktuelle Version von Salesforce for Outlook durch, die eine unterstützte API-Version verwendet.

Microsoft Power Query

Wenn API-Aufruf von Microsoft Power Query diese veralteten API-Versionen nutzen, befolgen Sie diese Anweisungen, um die von Microsoft Power Query verwendete API-Version zu aktualisieren.

Wo erhalte ich weitere Informationen?

Informationen zu den neuesten unterstützten API-Versionen finden Sie auf der Salesforce-Entwickler-Site.

Informationen zu APIs und ausgehendem Messaging:

• Plattform-API – Grundlagen (Trailhead)

• Introduction to SOAP API (Entwicklerhandbuch)

• Outbound Messaging (Entwicklerhandbuch)

• Introduction to Bulk API 2.0 and Bulk API (Entwicklerhandbuch)

• Introduction to REST API (Entwicklerhandbuch)

  • "REST" deckt alle APIs mit Endpunkt-URIs unter "/services/data/vXX.Y/" und "/services/metadata/vXX.Y/" ab, wobei "XX.Y" die API-Version darstellt. Dies schließt auch die "standardmäßige" Salesforce Platform-REST-API mit ein, die für sObjects und Datensätze verwendet werden kann, aber auch die folgenden Ressourcen:

    • Metadata API Developer

    • Tooling-API

    • Chatter-/Connect-API

    • Query- und Query All-APIs

    • Search-API

    • Limits-API

    • Login-API (auch "Identity")

  • Beobachten Sie die Ergebnisse einer REST-Anforderung für "GET /services/data/v40.0" oder "GET /services/metadata/v40.0", um nachzuvollziehen, welche Ressourcen der obersten Ebene betroffen sind, wenn die Endpunkte v40.0 und niedriger eingestellt werden.

Ich benötige weitere Hilfe. Was kann ich als Nächstes tun?

• Sehen Sie sich die oben aufgeführten Ressourcen an.

• Posten Sie in der Trailblazer Community.

• Wenden Sie sich über die Salesforce-Hilfe an den Salesforce-Support. Bitte merken Sie sich, was Sie bereits versucht haben und an welcher Stelle Sie nicht weiterkommen, damit der Support Ihnen so effizient wie möglich helfen kann. Beachten Sie, dass der Support die alten APIs in Ihrer Organisation nicht aktualisieren kann.

Unter Einstellungen von Salesforce-Produkten und -Funktionen finden Sie alle aktuellen und vergangenen Einstellungen. Mehr über die Vorgehensweise von Salesforce bei der Einstellung erfahren Sie in der Philosophie zur Einstellung von Produkten und Funktionen.