Import und Export

Echo kann Anfragen aus anderen API-Clients übernehmen, Sammlungen neben dem Quellcode speichern und Dokumentation erzeugen. Diese Vorgänge haben unterschiedliche Ergebnisse und gehen unterschiedlich mit Geheimnissen um.

Eine Sammlung oder Umgebung importieren

  1. Exportiere aus dem bisherigen Werkzeug und bewahre die Originaldatei auf.
  2. Öffne den Importbereich in Echos Einstellungen, wähle den Zielbereich und die Quelldatei. Echo erkennt das Format.
  3. Prüfe Vorschau, Anzahl der Einträge und Warnungen vor dem Bestätigen.
  4. Öffne eine importierte Anfrage, wähle ihre Umgebung und prüfe URL, Authentifizierung, Body und Skripte vor dem Senden.

Echo unterstützt Postman-Sammlungen und -Umgebungen. Unterstützte geerbte Postman-Authentifizierung wird in die importierten Anfragen übernommen; sie erzeugt keine bearbeitbare Authentifizierung auf Sammlungsebene in Echo. Binäre Inhalte und Dateiverweise lassen sich nicht einfach zwischen Rechnern übertragen und können mit einer Warnung ausgelassen werden. Nicht unterstützte Authentifizierung erzeugt ebenfalls einen Hinweis. Verbinde Dateien erneut und korrigiere Zugangsdaten vor dem Verwenden der Anfragen.

Insomnia-Exporte und Bruno-Sammlungen bieten weitere Wege. Die Datenmodelle unterscheiden sich. Prüfe das Ergebnis, statt davon auszugehen, dass jede ursprüngliche Funktion einen Export und erneuten Import übersteht.

Mit OpenAPI oder cURL beginnen

Importiere ein OpenAPI-3-Dokument als JSON oder YAML, um Anfragen aus seinen Operationen zu erstellen. Prüfe erzeugte URLs, Parameter, Inhalte und Sicherheitseinstellungen. Eine Spezifikation beschreibt eine API; ihr Import beweist nicht, dass der Server sie implementiert.

Der cURL-Importassistent nutzt KI und erfordert eine Pro-AI-Lizenz. Öffne ihn über die Befehlspalette oder das Menü für neue Anfragen und füge den Befehl ein. Prüfe URL, Methode, Header und Body, bevor du die Anfrage erstellst. Kontrolliere Zugangsdaten und Dateiverweise vor dem Senden. Zugriff und Datenverarbeitung erklärt der Leitfaden zu KI-Funktionen.

Ein Exportformat wählen

Der Postman-Export macht Sammlungen für dieses Werkzeug verfügbar; der Umgebungsexport erstellt eine separate Datei. Postman-Umgebungsexporte enthalten geheime Werte, die in der Datei als geheim markiert sind. Behandle diese Dateien wie Zugangsdaten und nicht wie bedenkenlos teilbare Anhänge.

Der OpenAPI-Export erzeugt ein OpenAPI-3.1-Dokument als JSON für HTTP-Operationen. Andere Protokolle werden als ausgeschlossen gezählt; das Format ist kein vollständiges Backup des Arbeitsbereichs. Prüfe Ergebnis und Spezifikation. Geheime Umgebungswerte werden in Servervariablen ausgelassen; direkt in Anfragen eingetragene Zugangsdaten musst du trotzdem prüfen.

Eine Sammlung mit einem Ordner verknüpfen

Verknüpfe über das Sammlungsmenü einen leeren Ordner, in den du schreiben kannst. Echo erstellt lesbare JSON-Dateien für Sammlung, Anfragen und Umgebungen. Verwende für jeden verknüpften Baum einen eigenen Ordner; überlappende Verknüpfungen werden abgelehnt.

Das Panel meldet Änderungen in Echo, auf dem Datenträger oder auf beiden Seiten. Export überträgt Echos Version in den Ordner; Import übernimmt die Ordnerversion in Echo. Haben sich beide geändert, prüfe den Konflikt und wähle ausdrücklich die anzuwendende Version. Automatischer Import ist optional. Das Aufheben der Verknüpfung löscht weder Sammlung noch Dateien.

Dieses Format lässt Werte geheimer Variablen aus, kann aber Geheimnisreferenzen erhalten. Das unterscheidet sich vom Postman-Umgebungsexport. Verwende Variablen für Zugangsdaten und prüfe Skripte, Inhalte und Header vor einem Commit. Echo führt keine Git-Commits oder Pushes aus. Die Desktop-CLI verwendet dasselbe Format.

Markdown nach DocuVault exportieren

Melde dich an, wähle eine Sammlung und starte den Dokumentationsexport. Echo erzeugt Markdown und lädt es in DocuVault hoch. Ein vorhandenes Dokument mit demselben erzeugten Namen erhält eine neue Version. Prüfe Abschlussmeldung und Datei vor dem Teilen.

Wiederhole den Export nach Änderungen an der Sammlung. Das Dokument bildet diesen Zeitpunkt ab; es übernimmt spätere Änderungen nicht automatisch.

Für synchronisierte Sammlungen können berechtigte Personen mit einem kostenpflichtigen Echo-Tarif im Veröffentlichungspanel eine Version veröffentlichen, ihre URL kopieren, sie aktualisieren, den Link erneuern oder den Zugriff widerrufen. Jeder mit dem öffentlichen Link kann das Dokument lesen. Prüfe Beispiele und Zugangsdaten vor dem Veröffentlichen.

Veröffentliche nach Sammlungsänderungen erneut. Das Erneuern des Links ersetzt die URL für Leser; ein Widerruf beendet den Zugriff auf die Veröffentlichung. Bereits heruntergeladene Kopien werden dadurch nicht zurückgeholt. Die Veröffentlichung ist von der DocuVault-Datei getrennt.

Wiederverwendbare Einstellungen erklärt Umgebungen. Die Konvertierung von C#, TypeScript, JavaScript, Java, Python und JSON Schema beschreibt Verträge.