In this lesson, you will set up a project in the Adobe Developer Console and download Postman collections so you can start using Platform APIs.
In order to complete the API exercises in this tutorial, download the Postman app for your operating system. Postman ist zwar nicht erforderlich, um Experience Platform-APIs zu verwenden, aber es erleichtert die API-Workflows und Adobe Experience Platform bietet Dutzende von Postman-Sammlungen, mit denen Sie API-Aufrufe ausführen und erfahren können, wie sie funktionieren. Der Rest dieses Tutorials geht davon aus, dass einige Arbeitskenntnisse des Postmanns vorhanden sind. Weitere Informationen finden Sie unter Postmanische Dokumentation.
Plattform ist API-first. Während Schnittstellenoptionen für alle wichtigen Aufgaben vorhanden sind, sollten Sie die Plattform-API irgendwann verwenden. Um beispielsweise Daten zu erfassen, verschieben Sie Elemente zwischen Sandboxen, automatisieren routinemäßige Aufgaben oder verwenden Sie neue Plattformfunktionen, bevor die Benutzeroberfläche erstellt wurde.
Datenarchitekten und Dateningenieure müssen möglicherweise die Plattform-API außerhalb dieses Tutorials verwenden.
In Berechtigungen konfigurieren Lektion erstellen Sie alle Zugriffskontrollen, die zum Abschluss dieser Lektion erforderlich sind.
Erstellen Sie auf Ihrem lokalen Computer einen Ordner mit dem Namen Luma Tutorial Assets
für Dateien, die im Tutorial verwendet werden.
Öffnen Sie die Adobe Developer Console
Melden Sie sich an und bestätigen Sie, dass Sie sich in der richtigen Org-Datei befinden
Auswählen Neues Projekt erstellen in Quick Beginn Menü.
In the newly created project, select the Add to Project button and then select API
Filtern der Liste durch Auswahl von Adobe Experience Platform
Wählen Sie in Liste der verfügbaren APIs Experience Platform-API und wählen Weiter.
Für die Authentifizierung von externen Systemen wie Postman, benötigen wir ein öffentliches/privates Schlüsselpaar. Um ein neues Schlüsselpaar zu erstellen, wählen Sie Option 1 und drücken Sie die Schlüsselbild generieren Schaltfläche
Sobald die Schlüssel bereit sind, werden Sie möglicherweise aufgefordert, die Schlüssel auf Ihren lokalen Computer herunterzuladen. Speichern Sie die Schlüssel im Paket config.zip
in den Ordner Luma Tutorial Assets
. Wir werden sie bei der nächsten Übung brauchen.
Nachdem der Schlüssel erstellt wurde, wird der öffentliche Schlüssel automatisch zu Ihrem Projekt hinzugefügt, wie im Screenshot dargestellt. Wählen Sie Weiter Schaltfläche.
Select the Luma Tutorial Platform
product profile and select the Save Configured API button
Now your Developer Console project has been created!
In Probieren Sie es aus Abschnitt der Seite auswählen Für Postman herunterladen und wählen Sie dann Dienstkonto (JWT) , um Postman JSON-Datei der Umgebung. Save the service.postman_environment.json
in your Luma Tutorial Assets
folder.
Systemadministratoren Ihres Unternehmens können das Projekt als "API-Anmeldedaten"im Profil des Produkts in der Admin Console betrachten.
Sie haben vielleicht bemerkt, dass dem Projekt eine Nummer zugewiesen wurde, z. B. "Projekt 12":
Wählen Sie die Projektnummer in der Breadcrumb aus
Wählen Sie Projekt bearbeiten Schaltfläche
Ändern der Projekttitel nach Luma Tutorial API Project
(fügen Sie Ihren Namen hinzu, wenn mehrere Personen Ihrer Firma diesen Lehrgang absolvieren)
Klicken Sie auf die Schaltfläche Speichern
Die Postman-Schnittstelle wird regelmäßig aktualisiert. Die Screenshots in diesem Tutorial wurden mit Postman v9.0.5 für Mac gemacht, aber die Schnittstellenoptionen haben sich möglicherweise geändert.
Herunterladen und installieren Postman
Open Postman and import the downloaded json environment file, service.postman_environment.json
In Postman, wählen Sie Ihre Umgebung im Dropdown-Menü aus
Wählen Sie Auge Symbol zur Ansicht der Umgebung-Variablen:
Since the exported name of the environment from Developer Console is randomly generated, give it a more descriptive name so you don't confuse environments later on when you start working on your real Platform implementation:
With the environment variables screen still open, select Edit on the top-right
Aktualisieren Sie die Name der Umgebung nach Luma Tutorial
Verlassen Umgebung verwalten Modal im Bearbeitungsmodus geöffnet, da wir es im nächsten Schritt weiter bearbeiten werden
Now it's time to add the PRIVATE_KEY value to the Postman environment
Download extrahieren config.zip
Datei, die in der vorherigen Übung beim Erstellen des Developer Console-Projekts erstellt wurde. Diese ZIP-Datei enthält zwei Dateien:
private.key
certificate_pub.crt
Open the private.key
file in a text editor and copy the contents.
In Postman, on the Manage Environments > Edit modal which is still open from the last exercise, paste copied values in front of PRIVATE_KEY in the Initial Value and Current Value columns.
Wählen Sie Speichern aus
Adobe bietet einen umfangreichen Satz von Postman Sammlungen, mit denen Sie die API der Experience Platform erkunden können. Diese Sammlungen befinden sich in Adobe Experience Platform Postman Samples GitHub-Repo. Sie sollten diesen Bericht mit einem Lesezeichen versehen, da Sie dies in diesem Tutorial mehrmals verwenden und später Experience Platform für Ihre eigene Firma implementieren.
Die erste Sammlung funktioniert mit den Adobe Identity Management Service (IMS) APIs. Es ist eine bequeme Möglichkeit, JWT_TOKEN und ACCESS_TOKEN von Postman aus zu befüllen für nicht produktionsbezogene Verwendungszwecke wie das Ausfüllen dieses Tutorials in Ihrer Sandbox. Alternativ kann der JWT-Token in der Adobe Developer Console erstellt werden. Da diese Sammlung jedoch regelmäßig abläuft, können Sie sie mit dieser Sammlung aktualisieren, ohne die Adobe Developer Console erneut aufrufen zu müssen, während Sie dieses Tutorial abschließen.
Wie bereits im Adobe Identity Management Service APIs BEREIT, sind die angegebenen Erzeugungsmethoden für die Verwendung in der Nicht-Produktion geeignet. Beim lokalen Signieren wird eine JavaScript-Bibliothek von einem Drittanbieter-Host geladen und beim Remote-Signieren wird der private Schlüssel an einen Webdienst der Adobe gesendet. Dieser private Schlüssel wird in der Adobe zwar nicht gespeichert, die Produktionsschlüssel sollten jedoch niemals für irgendjemanden freigegeben werden.
So generieren Sie die Token:
Laden Sie die Developer Console Zugriffstoken Generation Collection , um Luma Tutorial Assets
Ordner
Sammlung importieren in Postman
Anforderung auswählen IMS: JWT-Generierung + Auth über Benutzer-Token und wählen Senden
Die JWT_TOKEN und ACCESS_TOKEN in den Umgebung-Variablen von Postman.
Die SANDBOX_NAME
und TENANT_ID
und CONTAINER_ID
Variablen sind nicht im Export der Adobe Developer Console enthalten, daher werden sie manuell hinzugefügt:
In Postman, open the Environment Variables
Wählen Sie Bearbeiten Link rechts neben dem Namen der Umgebung
In Neues Variablenfeld Hinzufügen, eingeben SANDBOX_NAME
In beide Wertefelder eingeben luma-tutorial
, der Name, den wir in der vorherigen Lektion unserer Sandbox gegeben haben. Wenn Sie einen anderen Namen für Ihre Sandbox verwendet haben, z. B. luma-tutorial-ignatiusjreilly, stellen Sie sicher, dass Sie diesen Wert verwenden.
In Neues Variablenfeld Hinzufügen, eingeben TENANT_ID
Wechseln Sie zu Ihrem Webbrowser und suchen Sie die Mandanten-ID Ihrer Firma, indem Sie die Benutzeroberfläche der Experience Platform aufrufen und den Teil der URL extrahieren nach dem @-Zeichen. Meine Mandanten-ID ist z. B. techmarketingdemos
aber Ihrer ist anders:
Diesen Wert kopieren und zurück zu Postman Bildschirm "Umgebung verwalten"
Pächter-ID in beide Wertefelder einfügen
In Neues Variablenfeld Hinzufügen, eingeben CONTAINER_ID
Eingabe global
in beide Wertefelder
CONTAINER_ID
ist ein Feld, dessen Wert wir mehrmals während des Tutorials ändern. When global
is used, the API interacts with Adobe-provided elements in your Platform account. Wann tenant
verwendet wird, interagiert die API mit Ihren eigenen benutzerspezifischen Elementen.
Wählen Sie Speichern aus
Lassen Sie uns nun einen Platform API-Aufruf durchführen, um zu bestätigen, dass wir alles richtig konfiguriert haben.
Öffnen Sie die Experience Platform Postman Sammlungen in GitHub. Auf dieser Seite gibt es viele Sammlungen für verschiedene Plattform-APIs. Ich empfehle dringend, es mit Lesezeichen zu versehen.
Nun, machen wir unseren ersten API-Aufruf:
Luma Tutorial Assets
Ordnerapplication/vnd.adobe.xed-id+json
. Die Schema-Registry-APIs erfordern eine dieser angegebene Kopfzeilenwerte akzeptieren die verschiedene Formate in der Antwort bereitstellen.Hoffentlich haben Sie einen Erfolg 200 OK
Antwort mit einer Liste der verfügbaren Standard-XDM-Klassen in Ihrer Sandbox, wie unten dargestellt.
Wenn Ihr Anruf nicht erfolgreich war, versuchen Sie es mit den Fehlerantwort-Details des API-Aufrufs und überprüfen Sie die oben stehenden Schritte. Wenn Sie festsitzen, bitten Sie um Hilfe im Community-Forum oder verwenden Sie den Link auf der rechten Seite dieser Seite, um ein Problem zu protokollieren.
With your Platform permissions, sandbox, and Postman set up, you are ready to model data in schemas!