Postman in Adobe Experience Platform

Postman ist eine Kooperationsplattform für die API-Entwicklung, mit der Sie Umgebung mit voreingestellten Variablen einrichten, API-Sammlungen freigeben, CRUD-Anforderungen optimieren und mehr. Die meisten Plattform-API-Dienste verfügen über Postman-Sammlungen, mit denen API-Aufrufe durchgeführt werden können.

Einrichten einer Postman-Umgebung für Experience Platformen

Im folgenden Videoleitfaden wird das Erstellen und Einrichten Ihrer Postman-Umgebung beschrieben. Eine Postman-Umgebung enthält alle erforderlichen Kopfzeilen, die Sie zum Aufrufen der API für die verschiedenen Sammlungen unten angeben müssen. Nach der Einrichtung können Sie jederzeit, wenn ein Wert abläuft (z. B. ein ACCESS_TOKEN), den aktuellen Wert in der Umgebung aktualisieren. Dieser neue Wert wird in allen Sammlungen verwendet.

Postman-Sammlungen

Ein Ordner, der alle verfügbaren Postman-Sammlungen enthält, finden Sie unter Experience Platform Postman samples GitHub repository. Alternativ kann in jeder einzelnen Swagger-Datei in der API-Referenzdokumentation auf der Adobe I/O ein Postman-Sammlungslink gefunden werden.

Um eine Postman-Sammlung herunterzuladen, wählen Sie Raw auf der GitHub-Seite, um die JSON-Rohdatei in eine neue Registerkarte zu laden. Klicken Sie dann mit der rechten Maustaste und wählen Sie Save as, um die Datei an einem lokalen Ziel Ihrer Wahl zu speichern.

raw JSON

Importieren einer Postman-Sammlung

Um eine Postman-Sammlung verwenden zu können, müssen Sie eine Umgebung einrichten. Nachdem Sie die Umgebung eingerichtet haben, wählen Sie in der rechten oberen Ecke die Auswahl Manage Environments aus.

Auswahl für Umgebung verwalten

Es wird ein Popup angezeigt, in dem alle aktuellen Umgebung angezeigt werden. Um eine Sammlung zu importieren, wählen Sie import aus.

Schaltfläche importieren

Sie werden aufgefordert, eine zu importierende Datei auszuwählen. Wählen Sie die Postman-Sammlungsdatei aus, die Sie importieren möchten. Nach der Auswahl wird die Sammlung in der linken Leiste unter der Registerkarte "Sammlungen"angezeigt.

gefüllte Sammlung

Jede Sammlung verfügt über verschiedene Schlüssel/Wert-Paare, die für einen erfolgreichen CRUD-Vorgang erforderlich sein können. Bitte lesen Sie das API-Entwicklerhandbuch des Dienstes, um mehr über erforderliche Werte, Tipps und Beispiele zu erfahren.

Weitere Informationen zur Postman-Benutzeroberfläche und ihren verfügbaren Funktionen finden Sie in der Postman-Dokumentation.

Erstellen Sie ein Zugriffstoken mit Postman für die Verwendung ohne Produktionscharakter

WARNUNG

Wie in der Postman-Sammlung zur Adobe I/O-Zugriffstoken-Generierung angegeben, sind die angegebenen Generierungsmethoden für Nicht-Produktions-Verwendung geeignet. Beim lokalen Signieren wird eine JavaScript-Bibliothek von einem Drittanbieter-Host geladen, und durch das Fernsignieren wird der private Schlüssel an einen Webdienst gesendet, der sich im Besitz der Adobe befindet und von dieser betrieben wird. Während Adobe diesen privaten Schlüssel nicht speichert, sollten Produktionsschlüssel niemals für andere freigegeben werden.

Das folgende Video verwendet die Generierungssammlung Adobe I/O-Zugriffstoken, die aus dem öffentlichen GitHub-Repository heruntergeladen werden kann.

Nächste Schritte

In diesem Dokument wurden Umgebung, Sammlungen und das Importieren von Sammlungen in Postman vorgestellt. Sobald Sie Postman bereit haben, finden Sie im Handbuch Plattformstart Informationen zu erforderlichen Kopfzeilen, Beispielen und einer Liste der API-Handbücher, die für jeden Plattformdienst verfügbar sind.

Auf dieser Seite