Migration von Postman
1. Export aus Postman
Section titled “1. Export aus Postman”In Postman: Collection ▸ … ▸ Export ▸ Collection v2.1. Verfahren Sie ebenso für Ihre Umgebungen.
2. Import in Restorm
Section titled “2. Import in Restorm”Datei ▸ Importieren (Ctrl+I) und dann die JSON-Datei. Restorm erkennt
das Format selbstständig.
Details: Eine Postman-Collection importieren.
Was automatisch funktioniert
Section titled “Was automatisch funktioniert”| Postman | Restorm |
|---|---|
| Ordner | Ordner, auf derselben Tiefe |
| HTTP-Anfragen | HTTP-Anfragen |
| GraphQL-Anfragen | GraphQL-Anfragen (keine HTTP-Anfragen) |
| Raw-, Formdata-, Urlencoded-, File-, GraphQL-Body | Der entsprechende Body-Typ |
| Collection-Variablen | Variablen einer Umgebung |
| Beschreibungen | Notizen und API-Dokumentation |
| Beispielantworten | API-Dokumentation |
| Pre-Request- und Test-Skripte | Ein ausführbares Szenario, mit der pm.*-Schicht |
Was eine Anpassung erfordert
Section titled “Was eine Anpassung erfordert”Die Authentifizierung
Section titled “Die Authentifizierung”Postman-Authentifizierungsblöcke werden dokumentiert (sensible Werte maskiert), aber nicht in ausführbare Anmeldedaten umgewandelt.
Erstellen Sie eine
Authentifizierungsanfrage neu: Das ist
eine Sache von fünf Minuten, und Sie gewinnen dabei die automatische
Token-Erneuerung und den erneuten Versuch bei 401, was Postman nicht von
sich aus erledigt.
Die Umgebungen
Section titled “Die Umgebungen”Exportieren Sie sie aus Postman und legen Sie sie in einem Variablenordner neu an.
Nutzen Sie die Gelegenheit, um Unterumgebungen zu verwenden: Wo Postman pro Ziel eine flache Umgebung erzwingt, erlaubt Restorm eine gemeinsame Basis mit Überschreibungen pro Kunde oder Region.
Die Runner und Newman
Section titled “Die Runner und Newman”Das ist die lohnendste Ablösung. Ein Szenario leistet, was ein Runner leistet – nur besser:
- der Ablauf ist sichtbar, statt eine implizite Collection-Reihenfolge zu sein;
- Verzweigungen, Schleifen und Wiederholungen sind Bausteine, kein
pm.setNextRequest; - die Ausführung in CI ist integriert, mit sauberen Exit-Codes – siehe Headless-Ausführung und CI.
Konzeptäquivalenzen
Section titled “Konzeptäquivalenzen”| Postman | Restorm |
|---|---|
| Workspace | Ein Projekt .restorm, versioniert in git |
| Collection | Ein Ordner oder ein Variablenordner |
| Environment | Eine Umgebung in einem Variablenordner |
| Globals | Eine Wurzelumgebung, vererbt an ihre Kinder |
| Pre-request / Test script | Ein Szenario oder eine Code-Aktion |
| Collection Runner | Ein Szenario |
| Newman | restorm --run --headless |
| Mock Server | Der Servermodus, lokal |
| Monitors | Eine Aktion Timer oder ein geplanter Job Ihrer CI |
| Postman Console | Die Konsole |
Dynamische Variablen {{$random…}} | Dieselben, plus 116 Helper – siehe die Referenz |
Der grundlegende Unterschied
Section titled “Der grundlegende Unterschied”Ihre Anfragen werden zu Dateien in Ihrem Repository. Sie durchlaufen denselben Review-Zyklus wie Ihr Code, ihr Verlauf ist der Git-Verlauf, und die Zugriffsrechte sind die Ihrer Code-Plattform.
Kein gehosteter Arbeitsbereich zu verwalten, und keine API-Daten bei einem
Drittanbieter. Siehe
Projekte und .restorm-Dateien.
Und was Postman hat, das Restorm nicht hat
Section titled “Und was Postman hat, das Restorm nicht hat”Um ehrlich zu sein: Restorm hat keinen gehosteten kollaborativen Arbeitsbereich, kein öffentliches API-Portal, keine Inline-Kommentare zu Anfragen und kein gehostetes Monitoring. Wenn sich Ihre Organisation auf diese Elemente stützt, haben sie kein direktes Äquivalent – das Teilen läuft über git.