Importieren

Echolot importiert, was du aus anderen Tools schon hast, in einen Arbeitsbereich: Anfragen, Ordner, Auth, Variablen, Umgebungen und Skripte. Es erkennt das Format am Inhalt, legt Zugangsdaten im Schlüsselbund ab und sagt dir in einem Bericht, was es nicht übernehmen konnte.

Was Echolot importiertCopy Anchor Link

Eine Collection, eine Spec, eine HAR-Datei oder ein Bruno-Ordner landet in einem eigenen Ordner, der nach ihr benannt ist. Ein cURL-Befehl wird zu einer Anfrage.

Auch MCP-Server-Konfigurationen aus Claude Desktop, Claude Code, Cursor, VS Code und Codex lassen sich importieren, und zwar als MCP-Server: siehe Server hinzufügen.

In der App importierenCopy Anchor Link

Wähle einen dieser Wege. Der Import landet im Ordner, der in der Seitenleiste ausgewählt ist, oder ganz oben im Arbeitsbereich.

• Datei › Importieren … (⇧⌘I) oder Importieren … im Menü + der Seitenleiste oder in der Befehlspalette. Wähle eine oder mehrere Dateien oder einen Bruno-Collection-Ordner.
• Ablegen: Ziehe Dateien oder einen Bruno-Ordner irgendwo auf den Inhaltsbereich des Fensters oder auf einen Ordner in der Seitenleiste.
• Einsetzen: Setze einen cURL-Befehl oder den Text einer Collection oder einer Spec in die Seitenleiste ein (⌘V, während die Seitenleiste den Fokus hat).
• Füge einen cURL-Befehl in das Adressfeld einer Anfrage ein. Das legt keine neue Anfrage an: Es ersetzt Methode, Adresse, Header, Body, Auth und Einstellungen der geöffneten Anfrage und behält ihren Namen und Platz. Was Echolot nicht verwenden konnte, steht unter der Adressleiste als cURL-Hinweise.

Der ImportberichtCopy Anchor Link

Nach einem Import öffnet sich ein Bericht. Sein Titel sagt, was hereingekommen ist („22 Anfragen, 7 Ordner importiert“); darunter steht, aus welchen Formaten es stammt und ob alles importiert wurde. Dann folgt für jede Datei:

• Hinweise zu allem, was nicht unverändert übernommen werden konnte. Nichts fällt ohne Hinweis weg.
• Secrets: die Namen der Werte, die statt in den Dateien im Schlüsselbund gesichert wurden. Nie die Werte selbst.

In Seitenleiste anzeigen wählt das Importierte aus; Fertig schließt den Bericht. Ein einzelner cURL-Befehl ohne Hinweise öffnet sich sofort, ohne Bericht.

Secrets kommen in den SchlüsselbundCopy Anchor Link

Arbeitsbereichsdateien enthalten nie ein Passwort, ein Token oder einen Schlüssel im Klartext, sodass du sie in Git einchecken kannst.

• In Anfragen eingetragene Zugangsdaten (in der Auth, in einem Authorization-Header, in einem API-Key-Header) werden zu geheimen Variablen, benannt nach der Anfrage und dem Feld. Zum Beispiel erzeugt curl -u heidi:alpenglow https://demo.echolot.dev/echo/basic-auth/heidi/alpenglow eine Anfrage namens heidi-alpenglow, deren Passwort {{heidi_alpenglow_password}} ist; der Wert kommt in den Schlüsselbund.
• Geheime Werte von Umgebungen und Collections kommen auf dieselbe Weise in den Schlüsselbund.

Zugangsdaten in Query-Strings von Adressen, in Bodys und in Adressen der Form user:password@ werden noch nicht verschoben: Prüfe sie, bevor du einen importierten Arbeitsbereich eincheckst. Siehe Secrets.

SkripteCopy Anchor Link

Pre-Request- und Testskripte aus Postman werden übernommen und laufen in Echolots pm.*-Sandbox. Die App führt importierte Skripte erst aus, nachdem du ihnen vertraust: Der Bericht sagt, wie viele es waren, und das erste Senden, das sie braucht, bittet dich, sie zu prüfen (Skripte prüfen …). Die Skripte und Tests von Bruno werden wie geschrieben übernommen, aber Brunos bru, req und res sind nicht Postmans pm, daher brauchen sie womöglich Anpassungen, bevor sie laufen. Siehe Skripte und Tests.

Was nicht übernommen wirdCopy Anchor Link

Der Bericht nennt jeden dieser Fälle, wenn er eintritt:

OpenAPI-Dateien bleiben verknüpftCopy Anchor Link

Beim Import einer OpenAPI- oder Swagger-Datei behält Echolot außerdem eine Kopie im Ordner specs/ des Arbeitsbereichs, und der neue Anfragenordner folgt dieser Spec: Ändert sich die Spec, kann Echolot zeigen, was sich geändert hat, und es auf die Anfragen anwenden. Bearbeite die Spec auf der Seite Specs.

Über die Befehlszeile importierenCopy Anchor Link

echolot import übernimmt dieselben Formate in einen Arbeitsbereichsordner, sodass du eine Migration oder einen Import in CI skripten kannst:

echolot import Alpenglow.postman_collection.json -w "Alpenglow.echolot"
echolot import staging.postman_environment.json -w "Alpenglow.echolot"
echolot import openapi.yaml -w "Alpenglow.echolot" --folder catalog
pbpaste | echolot import - -w "Alpenglow.echolot"       # a cURL command from the clipboard

Es erkennt das Format am Inhalt; --format überspringt die Erkennung (curl, postman-collection, postman-environment, openapi, swagger, insomnia, har, paw oder mcp-config). Es gibt denselben Bericht aus:

Imported 22 requests, 7 folders from Postman collection v2.1.
warning: 19 pre-request or test scripts were imported; Echolot runs them once you trust them.

Auf einem Mac kommen Secrets wie in der App in den Schlüsselbund. Wo es keinen Schlüsselbund gibt (Linux oder ECHOLOT_KEYCHAIN=0), bleiben sie aus den Dateien heraus, und das Tool nennt dir, welche ECHOLOT_SECRET_<NAME>-Variablen du dort setzen musst, wo du sendest. Das Befehlszeilentool selbst führt jedes Skript ohne Nachfrage aus, wie Newman.

Du musst eine Postman-Collection nicht importieren, um sie auszuführen: echolot run collection.json führt sie so aus, wie sie ist. Siehe Import und Export und echolot run.

Den umgekehrten Weg beschreibt Exportieren.