Zum Inhalt springen

Eine Postman-Collection importieren

Restorm importiert Postman-Collections v2.0 und v2.1 (das Format, das „Export ▸ Collection v2.1“ in Postman erzeugt).

Datei ▸ Importieren (Ctrl+I) und dann die exportierte .json-Datei.

Der durch den Import einer Postman-Collection erzeugte Baum: ein Variablenordner an der Wurzel, ein Unterordner pro Postman-Ordner und eine Anfrage pro Eintrag mit ihrem Verb

Postman-ElementWas Restorm daraus macht
Ordner (verschachtelte item)Ordner, in derselben Tiefe
AnfragenHTTP-Anfragen — oder GraphQL, wenn der Body vom Typ graphql ist
Body raw, formdata, urlencoded, file, graphqlDer entsprechende Body-Typ
Collection-VariablenDie Variablen einer Umgebung
BeschreibungenDie Notizen der Anfrage und die API-Dokumentation
BeispielantwortenDie API-Dokumentation

Das ist der Teil, der diesen Import auszeichnet. Ihre Pre-Request- und Test-Skripte gehen nicht verloren: Sie werden in der Dokumentation aufbewahrt und in ein ausführbares Szenario umgewandelt, dessen Code-Bausteine das Skript unverändert ausführen.

Dafür stellt Restorm in seinen JavaScript-Code-Aktionen eine Kompatibilitätsschicht pm.* bereit: pm.environment, pm.variables, pm.response, pm.test, pm.expect, pm.sendRequest, pm.setNextRequest, pm.cookies … Ihre Assertionen funktionieren also weiter, ohne dass Sie sie neu schreiben müssen.

Die Postman-Authentifizierungsblöcke (oauth2, apikey, bearer, basic, digest, hawk, aws, ntlm, edgegrid) werden gelesen und in der API-Dokumentation zusammengefasst, wobei sensible Werte maskiert werden.

Sie werden nicht in ausführbare Anmeldedaten umgewandelt: Legen Sie eine Authentifizierungsroute neu an — das dauert fünf Minuten, und Sie gewinnen dabei die automatische Erneuerung des Tokens.

Postman gehört zu den re-synchronisierbaren Formaten (sofern die Collection aus einer URL importiert wurde): Die Schaltfläche Aktualisieren des Ordners ruft die Quelle erneut ab, und Restorm wendet das Delta an. Siehe Aktualisierung aus der Quelle.

Der Leitfaden Migration von Postman führt durch die vollständige Migration, einschließlich Umgebungen und Runner.