Postbote und Musteranfragen

Braze ermöglicht es Ihnen, über unsere Postman Collection API-Anfragen für alle unsere Endpunkte zu generieren. Dieser referenzierte Artikel behandelt die Braze Postman Collection, was sie ist, wie Sie die Collection einrichten und verwenden und wie Sie Anfragen bearbeiten und versenden können.

Was ist Postman?

Postman ist ein kostenloses visuelles Bearbeitungstool zum Erstellen und Testen von API-Anfragen. Im Vergleich zu anderen Methoden (z.B. cURL) können Sie mit Postman API-Anfragen bearbeiten, Header-Informationen einsehen und vieles mehr. Sie können Sammlungen (Bibliotheken mit vorgefertigten API-Anfragen) speichern. Um die Einrichtung mit unserer REST API zu beschleunigen, stellen wir eine Sammlung mit vorgefertigten Beispielen für alle Endpunkte zur Verfügung.

Sehen Sie sich unsere Postman Collection an oder laden Sie sie herunter, indem Sie auf Run in Postman in unseren Postman-Dokumenten klicken.

Verwendung der Braze Postman Kollektion

Wenn Sie ein Postman-Konto haben (Sie können die macOS-, Windows- und Linux-Versionen von der Postman Website herunterladen), können Sie unsere Dokumentation in Ihrer eigenen Postman App öffnen, indem Sie auf den orangefarbenen Button In Postman ausführen klicken. Sie können dann eine Umgebung erstellen oder unsere Braze REST API-Umgebung als Template verwenden und die verfügbaren POST und GET Anfragen nach Ihren eigenen Bedürfnissen bearbeiten.

Einrichten Ihrer Postman-Umgebung

Die Braze Postman Collection verwendet eine Template-Variable, {{instance_url}}, um die REST API-URL Ihrer Braze-Instanz in den vorgefertigten Anfragen zu ersetzen, und die Variable {{api_key}} für Ihren API-Schlüssel. Anstatt alle Anfragen in der Collection manuell zu bearbeiten, können Sie diese Variable in Ihrer Postman-Umgebung einrichten. Sie können entweder unsere Template-Umgebung (Braze REST API Environment Template) aus dem Dropdown-Menü auswählen und die Variablenwerte durch Ihre eigenen ersetzen, oder Sie können Ihre eigene Umgebung einrichten.

Um Ihre eigene Umgebung einzurichten, führen Sie die folgenden Schritte aus:

1. Wählen Sie auf dem Tab Workspaces die Option Umgebungen aus.
2. Klicken Sie auf den + plus Button, um eine neue Umgebung zu erstellen.
3. Geben Sie dieser Umgebung einen Namen (z.B. “Braze API Requests”) und fügen Sie Schlüssel für instance_url und api_key mit Werten hinzu, die Ihrer Braze-Instanz und Ihrem Braze REST API-Schlüssel entsprechen.
4. Klicken Sie auf Speichern.

Hinweis

In POST Anfragekörpern sollte die api_key in Anführungszeichen eingeschlossen sein: "MY-API-KEY-EXAMPLE". In GET URLs sollte dies nicht der Fall sein. Wir haben diese Formatierung bereits in den POST Anfragekörpern, GET URLs und der Umgebungsvorlage für YOUR-API-KEY-HERE in dieser Dokumentation für Sie bereitgestellt.

Verwendung der vorgefertigten Anfragen aus der Sammlung

Nachdem Sie Ihre Umgebung konfiguriert haben, können Sie jede der vorgefertigten Anfragen in der Sammlung als Template für die Erstellung neuer APIs verwenden. Um eine der vorgefertigten Anfragen zu verwenden, klicken Sie im Menü Sammlungen von Postman auf diese. Dadurch wird die Anfrage in einem neuen Tab im Hauptfenster der Postman App geöffnet.

Im Allgemeinen gibt es zwei Arten von Anfragen, die Braze API Endpunkte akzeptieren - GET und POST. Je nachdem, welche HTTP Methode der Endpunkt verwendet, müssen Sie die vorgefertigte Anfrage anders bearbeiten.

Bearbeiten einer POST-Anfrage

Wenn Sie eine POST Anfrage bearbeiten, öffnen Sie die Anfrage und navigieren Sie zum Abschnitt Body im Anfrage-Editor. Um die Lesbarkeit zu verbessern, wählen Sie den Button Rohdaten aus, um den Body der Anfrage JSON zu formatieren.

Eine GET-Anfrage bearbeiten

Wenn Sie eine GET Anfrage bearbeiten, bearbeiten Sie die in der Anfrage-URL übergebenen Parameter. Wählen Sie dazu den Tab Params und bearbeiten Sie die Schlüssel-Wert-Paare in den angezeigten Feldern.

Senden Sie Ihre Anfrage

Nachdem Ihre API-Anfrage fertig ist, klicken Sie auf Senden. Die Anfrage wird gesendet und die Daten der Antwort werden in einem Bereich unterhalb des Anfrage-Editors angezeigt. Von hier aus können Sie die von der Braze API zurückgegebenen Rohdaten, den HTTP Response Code, die Dauer der Bearbeitung der Anfrage und die Header-Informationen einsehen.