Du kommst von Postman

Echolot liest Postman-Collections und -Umgebungen, wie sie sind, Skripte eingeschlossen. In diesem Tutorial importierst du eine Collection, siehst, wohin jeder Teil gekommen ist, führst sie aus und exportierst einen Arbeitsbereich zurück nach Postman.

• Dauer: 15 Minuten.
• Du brauchst: eine Postman-Collection (v2.0 oder v2.1) und ihre Umgebungen, als JSON exportiert. Keine Collection zur Hand? Erzeuge in Schritt 1 eine aus Alpenglow.
• Du lernst: Importieren, was wohin passt, importierten Skripten vertrauen, eine Collection mit oder ohne Import ausführen und Exportieren.

1. Eine Collection besorgenCopy Anchor Link

Aus Postman: Öffne das Menü ⋯ der Collection, wähle Export und lass Collection v2.1. Exportiere jede Umgebung auf dieselbe Weise aus ihrem eigenen Menü.

Um stattdessen mit Alpenglow zu üben:

1. Öffne den Arbeitsbereich Alpenglow und wähle Datei › Arbeitsbereich exportieren … (⇧⌘E).
2. Wähle Postman Collection v2.1. Ihre Zeile sagt, dass 21 der 29 Anfragen passen: Postman-Collections haben keine WebSocket-, Socket.IO-, MQTT-, gRPC- oder MCP-Anfragen, daher bleiben diese zurück.
3. Lass Umgebungen einschließen (3) an und wähle Exportieren …. Mit Umgebungen ist der Export ein Ordner mit Dateien: Gib ihm einen Namen und wähle Exportieren.

Der Ordner enthält Alpenglow.postman_collection.json und eine .postman_environment.json pro Umgebung. Der Bericht listet auf, was Ausgelassen wurde und was Beim Export geändert wurde: Echolots Prüfungen wurden zu pm.test()-Skripten, Erfassungen aus Antworten werden nicht exportiert, und geheime Variablen gehen nur mit ihrem Namen hinaus, ohne ihre Werte.

2. ImportierenCopy Anchor Link

1. Lege einen neuen Arbeitsbereich an: Datei › Neuer Arbeitsbereich … (⌥⌘N), benannt From Postman.

2. Wähle Datei › Importieren … (⇧⌘I). Wähle die Collection und die Umgebungsdateien zusammen aus und wähle Importieren.

   Du kannst die Dateien auch auf das Fenster ziehen oder das JSON einer Collection kopieren und in die Seitenleiste einsetzen (⌘V).

3. Der Bericht, … importiert, listet jede Datei mit ihrem Format (Postman collection v2.1, Postman environment) und dem, was hereingekommen ist. Hinweise sagen, was nicht so übernommen werden konnte, wie es war.

Beim Alpenglow-Export sagen die Hinweise, dass 19 Testskripte importiert wurden und laufen, sobald du ihnen vertraust, und dass 2 geheime Werte im Schlüsselbund gesichert wurden, nicht in den Dateien des Arbeitsbereichs: das Demo-Passwort und das OAuth-Client-Secret, die in die Collection getippt waren. Die Anfragen verweisen jetzt als {{password}} und {{orders_with_oauth_2_clientSecret}} darauf. Wähle In Seitenleiste anzeigen.

3. Dich zurechtfindenCopy Anchor Link

Datei-Bodys und Dateifelder von form-data kommen nicht herein, da die Datei auf einem anderen Computer liegt: Der Bericht nennt jede einzelne, sodass du die Datei im Tab Body neu auswählen kannst.

4. Den Skripten vertrauenCopy Anchor Link

Skripte können alles, was ein Skript kann, daher laufen importierte erst, wenn du es sagst.

1. Öffne eine Anfrage mit einem Testskript, etwa Catalog › List products, und ihren Tab Skripte. Ein Banner sagt Diese Skripte stammen nicht aus Echolot.
2. Lies das Skript und wähle Skripten vertrauen. Sendest du zuerst, fragt Echolot, und Vertrauen und senden vertraut und sendet sofort.
3. Sende. Die pm.test()-Ergebnisse des Skripts erscheinen im Tab Tests der Antwort unter Skripte.

Skripte laufen in Echolots eigener JavaScript-Sandbox, nicht in Node. Siehe Skripte und Tests und die Skript-API.

5. AusführenCopy Anchor Link

1. Wähle im Seitenkopf die Umgebung, die du importiert hast, etwa Staging, oder Keine Umgebung für die Demo-API von Alpenglow.
2. Klicke mit der rechten Maustaste auf den Ordner der Collection und wähle Ordner ausführen. Die Ausführung führt jede Anfrage mit ihren Skripten und Prüfungen aus.

Das Befehlszeilentool führt eine Collection ohne Import aus, wie Newman. Skripte laufen dort ohne Nachfrage:

echolot run Alpenglow.postman_collection.json --folder catalog --reporter console --reporter junit --out results.xml

--env-file nimmt eine Postman-Umgebungsdatei, --folder den Namen eines Ordners in Kleinbuchstaben mit Bindestrichen (catalog, agent-tools), und --data users.csv läuft einmal pro Zeile. Geheime Werte kommen aus ECHOLOT_SECRET_<NAME>-Umgebungsvariablen.

6. Was anders funktioniertCopy Anchor Link

• Alles ist eine Datei. Ein Arbeitsbereich ist ein Ordner mit TOML-Dateien, eine pro Anfrage, bereit für Git. Es gibt kein Konto und keinen Sync-Dienst; Teams teilen über Git. Siehe Git und Teams.
• Sichern geschieht automatisch. Es gibt kein ⌘S; am Fuß der Seitenleiste steht Alles gesichert.
• Secrets kommen nie in Dateien. Der Wert einer geheimen Variablen liegt im Schlüsselbund dieses Macs; die Datei enthält nur ihren Namen.
• Prüfungen ohne Code. Der Tab Tests prüft Status, Header, JSON-Werte, die Zeit, ein JSON Schema oder eine OpenAPI-Spec ohne Skript. Siehe Skripte und Tests.
• Erfassungen ohne Code. Statt pm.environment.set("token", …) in einem Testskript hältst du den Zeiger auf den Wert in der Antwort und wählst In Variable speichern …. Siehe Anfragen verketten.
• Mehr als HTTP. Derselbe Arbeitsbereich enthält WebSocket-, Socket.IO-, MQTT-, gRPC- und MCP-Anfragen, Specs, Mocks und Flows.

7. Zurück nach Postman exportierenCopy Anchor Link

1. Wähle Datei › Arbeitsbereich exportieren … oder klicke mit der rechten Maustaste auf einen Ordner und wähle Ordner exportieren ….
2. Wähle Postman Collection v2.1. Das Blatt sagt, wie viele Anfragen passen; WebSocket und die anderen Sitzungsarten bleiben zurück. Insomnia v5 trägt auch WebSocket, Socket.IO und gRPC, und Bruno-Sammlung schreibt einen Ordner mit .bru-Dateien.
3. Wähle, ob du Umgebungen einschließen willst, dann Exportieren ….

Zugangsdaten, die du in Auth- oder Header-Felder getippt hast, werden im Klartext geschrieben, und der Bericht sagt, wie viele: Verschiebe sie zuerst in geheime Variablen. Geheime Variablen gehen mit ihrem Namen hinaus, ohne ihre Werte. Siehe Exportieren.

Nächste SchritteCopy Anchor Link

• Dein erster Arbeitsbereich: wie ein Arbeitsbereich aufgebaut ist.
• Importieren: auch Insomnia, OpenAPI, HAR, cURL, Paw und Bruno.
• Eine API testen und in CI ausführen: Ersetze Newman in deiner Pipeline.