Von KI übersetzt. Noch nicht von der Community geprüft. Auf Englisch lesen

Blog · 10. Oktober 2023 · Steve Simpson · Integration

Across the APIs: Überblick über die Salesforce-APIs

Willkommen zu einer weiteren Folge der Integrationsreihe. Diesmal erkunden wir die vielschichtige Welt der Salesforce-APIs, ein entscheidender Baustein für wirksame Integrationen.

Einführung in die Salesforce-APIs

Orientierung in den Salesforce-APIs

Salesforce bietet eine Fülle von APIs, jede mit einem eigenen Zweck und eigenen Funktionen. Dieser Leitfaden führt Sie durch diese APIs und hilft Ihnen zu verstehen, wie Sie sie für verschiedene Integrationsaufgaben wirksam einsetzen.

Authentifizierung verstehen

Bevor wir uns den APIs zuwenden, ist es wichtig, den Authentifizierungsprozess zu verstehen. Wenn ein Browser auf Salesforce zugreift, authentifiziert er sich bei einem Server, bevor er die privaten Inhalte erreicht. Diese Authentifizierung ist entscheidend, ob Sie auf öffentliche Websites, Experience-Portale oder sogar auf öffentliche Seiten für Web-to-Lead und Web-to-Case zugreifen.

Diagramm: Zugriff auf Salesforce und APIs. Eine Client-Anwendung und ein Browser authentifizieren sich über den Authentifizierungsserver und erreichen dann versionierte Webdienste (die Standard-APIs), nicht versionierte benutzerdefinierte REST- und SOAP-Dienste, öffentliche Sites, Web-to-Lead und Email-to-Case

Versionierte und nicht versionierte Webserver

Warum Versionierung wichtig ist

Salesforce veröffentlicht APIs unter bestimmten Versionsnummern und erhält deren Funktionen und Kompatibilität über Jahre, bis sie schliesslich eingestellt werden.

Als Nutzer:in müssen Sie wissen, welche Version Sie verwenden, und bereit sein, auf neuere Versionen umzusteigen (mit Tests).

Benutzerdefinierte REST- und SOAP-APIs

Für benutzerdefinierte REST- oder SOAP-APIs, die Sie selbst erstellen, bietet Salesforce keine Versionierung. Sie sind selbst dafür verantwortlich, diese APIs zu verwalten und zu pflegen und sicherzustellen, dass sie nach jedem Salesforce-Update wie erwartet funktionieren.

Diagramm: die Salesforce-APIs, die ein externer Client aufrufen kann (SOAP, REST, Bulk, Apex SOAP und REST, Metadata, Tooling, Streaming und Pub/Sub), nachdem er sich über eine verbundene App und einen Integrationsbenutzer authentifiziert hat

Authentifizierung externer Clients

Wenn externe Clients auf Salesforce zugreifen, müssen sie sich über bestimmte Flows authentifizieren. Diese Clients können verschiedenster Art sein, darunter SOAP-Clients mit der Enterprise- oder Partner-WSDL, REST-Clients, Bulk-API-Clients und viele andere.

Verschiedene APIs erkunden

Salesforce bietet eine grosse Bandbreite an APIs, jede für bestimmte Aufgaben und Funktionen entworfen. Vom neuen Salesforce Event Bus bis zu APIs für Branchen wie Gesundheitswesen und Fertigung gibt es für fast jeden Bedarf eine API.

Screenshot: die Seite Browse APIs auf der Salesforce-Developers-Website mit einer Liste von API-Karten

https://developer.salesforce.com/docs/apis (opens in a new tab)

Werkzeuge und Ressourcen

Postman: der beste Freund in der Entwicklung

Für alle, die mit Salesforce-APIs entwickeln, sind Werkzeuge wie Postman unbezahlbar. Mit Postman können Sie Authentifizierungen und Abfragen ausführen und sogar Daten von ausserhalb von Salesforce einfügen, bearbeiten, aktualisieren oder löschen, ein unverzichtbares Werkzeug für API-Tests und -Entwicklung.

Screenshot: eine Postman-Anfrage, die eine SOQL-Abfrage gegen die Salesforce-REST-API ausführt, mit Authorization-Header und JSON-Antwort

Dokumentation und Collections nutzen

Sich mit der verfügbaren Dokumentation vertraut zu machen, ist der Schlüssel zur Beherrschung der Salesforce-APIs. Ressourcen wie der REST API Developer Guide und verschiedene Postman-Collections auf GitHub können Ihre Entwicklung deutlich erleichtern.

Fazit:

Die Salesforce-APIs zu verstehen und wirksam zu nutzen, ist für alle in der Integrationsentwicklung oder -architektur mit Salesforce entscheidend. Mit einer grossen Bandbreite an APIs und Werkzeugen können Sie Daten und Konfigurationen in Salesforce effizient bearbeiten, lesen, ändern und aktualisieren.

Erkunden, experimentieren und integrieren Sie nach Herzenslust!

Bleiben Sie dran

Starten Sie mit Zuversicht in Ihre Reise durch die Salesforce-APIs! Weitere Einblicke und Tipps gibt es hier auf www.SteveTechArc.com und auf dem YouTube-Kanal @SteveTechArc (opens in a new tab). Abonnieren Sie und vertiefen Sie Ihr Verständnis von Salesforce und davon, wie Sie es mit anderen Systemen integrieren.

Die Welt ein Stück verändern, indem ich Wissen über Integration mit anderen Architekt:innen und allen auf dem Weg dorthin teile!

Transkript mit Unterstützung von KI

STA 1.9