Import
Ein Import legt aus dem Export eines anderen Werkzeugs einen neuen Collection-Ordner an. Was sich nicht genau übertragen lässt, verschweigt RequestTailor nicht: Jeder Import endet mit einem Verlustbericht, der sagt, was fehlt oder nur angenähert ist – und wo.
- Edition
- Free
- Quellen
- Postman, Insomnia, OpenAPI, cURL, HAR, .http
- Ergebnis
- ein neuer Collection-Ordner
- Bericht
- jeder Verlust mit Ort und Wirkung
- Kommandozeile
rt import
Was sich importieren lässt
| Quelle | Versionen |
|---|---|
| Postman | Collections v2.0 und v2.1, mit Umgebungs- und Globals-Dateien |
| Insomnia | Exporte v4 und v5 |
| OpenAPI | 3.0 bis 3.2 |
| cURL | Kommandozeilen |
| HAR | 1.2 |
| .http | VS Code REST Client und JetBrains HTTP Client, mit ihren Umgebungsdateien |
Plugins können eigene Importer mitbringen, etwa das OData-Plugin einen für $metadata (OData und SAP).
Importieren

- Oben links Import klicken oder Import collection… in der Befehlspalette wählen.
- Die Export-Dateien auf die Fläche ziehen oder choose files klicken. Umgebungsdateien gehören dazu: bei Postman die Umgebungen und Globals, bei .http die
http-client.env.json. - Für einzelne cURL-Befehle oder .http-Requests den Text ins Feld darunter einfügen und Convert pasted text klicken. Format steht auf Detect automatically; nur wenn die Erkennung danebenliegt, wählst du es selbst.
- Den Verlustbericht lesen (siehe unten).
- Choose folder and import klicken und den Ordner wählen, in dem die neue Collection entstehen soll.
Der Verlustbericht
Jeder Import liefert einen Verlustbericht1. Er nennt jeden Verlust mit seinem Ort (etwa Users / Get user), seiner Art und seiner Wirkung, gruppiert nach Bereichen:

- Dropped: nicht in der neuen Collection.
- Approximated: in ihr, aber nicht genau wie in der Quelle.
Copy report kopiert den Bericht als Text, etwa für ein Ticket. Ein Bericht mit Verlusten hält den Import nicht auf; du entscheidest, ob das Ergebnis reicht.
Secrets und Zugangsdaten
Secret-Werte aus der Quelle schreibt RequestTailor nie: Postman-Variablen vom Typ secret, private Umgebungen von Insomnia und die private Umgebungsdatei von JetBrains werden zu Secret-Variablen ohne Wert. Den Wert trägst du danach unter Environments ein (Secret-Variablen). Zugangsdaten, die in Requests getippt waren, bleiben wie in der Quelle – jede bekommt eine Zeile im Bericht mit dem Hinweis, eine Secret-Variable daraus zu machen. Vor dem ersten Commit fängt sie sonst der Secret-Scanner.
Skripte und Tests
Skripte und Tests aus Postman und Bruno übernimmt der Import unverändert; pm.* und bru.* laufen über Shims auf der Skript-API von RequestTailor. Der Bericht nennt die Stellen, die eine nicht unterstützte API benutzen. Mehr dazu in Skripte, Tests und Runner.
Auf der Kommandozeile
rt import shop.postman_collection.json prod.postman_environment.json --out ./shop
rt import api.yaml --format openapi --out ./api --json
--out muss neu oder leer sein. --format ist postman, insomnia, openapi, curl, har oder http; ohne die Angabe erkennt rt das Format je Datei. Exit-Code 0, sobald die Collection geschrieben ist – auch wenn der Bericht Verluste nennt –, 2, wenn die Dateien nicht lesbar sind oder --out belegt ist.
Siehe auch
- Funktionen im Überblick Funktionen · dateien
- Doku Collections als Dateien
- Doku Umgebungen und Variablen
- Doku Skripte, Tests und Runner
- Doku Kommandozeile rt
- Belege Importer1 · Shims2