OpenAPI zu Postman-Sammlung
Konvertiert ein OpenAPI- oder Swagger-Dokument in eine einsatzbereite Postman-v2.1-Sammlung.
OpenAPI zu Postman-Sammlung
Füge ein OpenAPI-3- oder Swagger-2-Dokument ein – JSON oder YAML – und dieses Tool erstellt eine Postman-v2.1-Sammlung, die du direkt in Postman, Insomnia oder jeden anderen Client importieren kannst, der das Format unterstützt. Jeder Operation in der Spezifikation wird zu einer Anfrage, organisiert in Ordnern, damit eine große API überschaubar bleibt statt als eine flache Liste zu landen.
Gruppiere Anfragen nach Tags oder nach dem ersten Pfadsegment – je nachdem, wie dein Team die API bereits durchdenkt. Aktiviere "Basis-URL als Umgebungsvariable einfügen", um die Server-URL durch eine {{baseUrl}}-Variable zu ersetzen, damit der Wechsel zwischen Staging und Produktion eine einzelne Umgebungsänderung ist statt jede Anfrage zu bearbeiten. "Auth-Header aus dem Sicherheitsschema hinzufügen" liest die Bearer-, API-Schlüssel- oder OAuth2-Definitionen der Spezifikation und fügt den entsprechenden Authorization- oder Key-Header als Platzhalter hinzu. "Beispiel-Anfragetexte aus Schemas generieren" erstellt anhand des Schemas ein JSON-Beispiel für jede Anfrage, folgt $ref-Referenzen im Dokument, damit POST- und PUT-Anfragen bereits vorausgefüllt statt leer ankommen. Abfrageparameter können mit ihren Beschreibungen einbezogen werden, veraltet markierte Endpoints können ganz übersprungen werden, und jeder Anfrage kann ein einfaches Testskript zur Überprüfung eines erfolgreichen Statuscodes hinzugefügt werden.
Pfadparameter wie {id} werden automatisch zu Postman-Pfadvariablen :id, und CRLF- und LF-Zeilenumbrüche in einem eingefügten Dokument werden gleich behandelt. Große Spezifikationen mit Hunderten von Operationen werden in einem Durchgang konvertiert; sollte die Sammlung das Ausgabelimit überschreiten, wird dies angezeigt, statt den Tab einzufrieren.
Alles findet lokal in deinem Browser statt – das eingefügte Dokument, einschließlich eventueller interner API-Details, wird nirgendwo hochgeladen. Wenn die Sammlung bereit ist, kannst du sie kopieren, als Datei herunterladen oder sie zur weiteren Bearbeitung an ein anderes Tool senden.