Salesforce API über Postman verbinden
In dieser Schritt-für-Schritt Anleitung gehen wir darauf ein, wie man die Salesforce REST-API über Postman verbindet und beispielhaft einen Account über die API erstellen kann.
Über Postman:
Postman ist eine API-Plattform für die Erstellung und Nutzung von APIs. Postman vereinfacht jeden Schritt des API-Lebenszyklus und vereinfacht die Zusammenarbeit, sodass APIs schneller und besser erstellt werden können. Es bietet einfache Möglichkeiten um zu verstehen, wie eine API funktioniert, welche Daten zurückgegeben werden usw.
Schritt 1: Erstellen einer Verbunden-Anwendung in Salesforce
Im Salesforce Setup muss der Menüpunkt „Anwendungs-Manager“ aufgerufen werden. Dort gibt es die Möglichkeit eine sogenannte „Verbundene Anwendung“ zu erstellen, welche die Grundlage für die API darstellt. In der verbundenen Anwendung müssen folgende Informationen angegeben werden:
- Name der verbundenen Anwendung
- API Name (Wird automatisch generiert)
- Kontakt-E-Mail (Für Benachrichtigungen bei Problemen mit der verbundenen Anwendung)
- oAuth Einstellungen müssen aktiviert werden
- Die Rückmeldungs-URL muss gesetzt werden auf: https://login.salesforce.com/services/oauth2/callback
- In Ausgewählte OAuth-Geltungsbereiche muss mindestens „API-basierte Verwaltung von Benutzerdaten (api)“ ausgewählt werden.
Schritt 2: Abrufen des Verbraucherschlüssels und des Verbrauchergeheimnis
Sobald Schritt 1 erfolgreich abgeschlossen und die Anwendung gespeichert wurde, werden Verbraucherschlüssel und Verbrauchergeheimnis generiert. Diese werden für die Authentifizierung im weiteren benötigt und können in der neu erstellten Anwendung abgerufen werden:
Schritt 3: Einrichten der Authentifizierung in POSTMAN
Für die Authentifizierung und um einen Token von Salesforce als Grundlage für weitere API-Requests zu erhalten muss in POSTMAN ein POST-Request mit folgenden Informationen eingerichtet werden:
URL: https://SALESFORCEDOMAIN.my.salesforce.com/services/oauth2/token?
In unserem Beispiel: https://ailo-it6-dev-ed.my.salesforce.com/services/oauth2/token?
form-body:
grant_type: password
client_id: In der oben erstellten verbundenen Anwendung zu finden
client_secret: In der oben erstellten verbundenen Anwendung zu finden
username: Salesforce Benutzername
password: Salesforce Passwort UND Sicherheitstoken
Schritt 4: Einrichten eines POST-Requests um einen Account in Salesforce zu erstellen
In Postman wird ein neuer POST Request eingerichtet mit folgenden Informationen eingerichtet:
- URL: https://SALESFORCEDOMAIN.my.salesforce.com/services/data/v39.0/sobjects/Account
- Im Reiter Authorization muss der Type „Bearer Token“ ausgewählt werden und als Token der Token aus der Response in Schritt 3 eingetragen werden.
- Im Reiter Headers muss (nicht zwingend, aber für unser Beispiel) der Content-Type „application/json“ eingetragen werden
- Im Reiter Body wählen wir „raw“ aus und geben den Post-Request im json-Format ein, siehe Screenshot.
Hinweis: Das Zugriffstoken hat eine Gültigkeitsdauer von wenigen Stunden und falls es abläuft, müssen die die gleichen Schritte ausgeführt werden, um ein neues Zugriffstoken zu erhalten, daher ist es besser, diese Anfrage zu speichern.