# OpenAPI zu Postman Collection

Wandelt eine OpenAPI-3.x- oder Swagger-2.0-Spec (JSON/YAML) in eine importierbare Postman Collection v2.1.0 mit Ordnern, Variablen, Auth und Beispielantworten.

> Kanonische Seite: https://elysiatools.com/de/tools/openapi-to-postman-collection

- **Kategorie:** Development

- **Schlagwörter:** openapi zu postman, swagger zu postman, postman import, openapi konverter, api tests, newman

## Überblick

Spec einfügen, Collection herunterladen, in Postman importieren (Import → File) oder mit Newman ausführen — keine Node-Pakete nötig. Der Konverter folgt den Konventionen von Postmans eigenem openapi-to-postman: servers[0] wird zur Variablen {{baseUrl}} (Trailing-Slashes entfernt, zusätzliche Server als baseUrl_2…, Server-Variablen wie {port} werden Collection-Variablen); Pfad-Ordner bilden einen zusammengelegten Trie (oder Tags verwenden); Pfadparameter werden zu :param-Segmenten plus url.variable; Query-/Header-Parameter erhalten “(Required) ”-Präfix und Enum-Hinweise; JSON-Bodies entstehen mit deterministischen Werten (example → erstes Enum → default → nach Format → Heuristiken wie user@example.com); pro Statuscode werden Beispielantworten gespeichert; bearer/basic/apiKey-Schemata werden Collection-Auth mit {{bearerToken}}/{{apiKey}}. Swagger 2.0 läuft über eine Kompatibilitätsschicht. Cookie-Parameter werden mit Warnung verworfen.

## Eingaben

- **OpenAPI-/Swagger-Spezifikation (JSON oder YAML)** (textarea): { "openapi": "3.0.3", "info": { "title": "My API" }, …
- **Ordnerstrategie** (select)
- **Beispielantworten einbeziehen** (checkbox)
- **Sicherheitsschemata in Auth umwandeln** (checkbox)

## Wann verwenden

- Wenn eine OpenAPI- oder Swagger-Spezifikation schnell für manuelle API-Tests in Postman importiert werden soll.
- Wenn automatisierte Test-Pipelines mit Newman aufgesetzt werden und dafür eine aktuelle Collection aus der API-Definition benötigt wird.
- Wenn Endpunkte, Pfadparameter, Authentifizierung und Beispieldaten nicht manuell in Postman angelegt werden sollen.

## Funktionsweise

- Fügen Sie Ihre OpenAPI-3.x- oder Swagger-2.0-Spezifikation als JSON- oder YAML-Text in das Eingabefeld ein.
- Wählen Sie die gewünschte Ordnerstruktur (nach Pfaden oder OpenAPI-Tags) und aktivieren Sie Optionen für Beispielantworten und Authentifizierung.
- Laden Sie die generierte Postman-Collection-v2.1.0-Datei herunter und importieren Sie diese über „Import → File“ in Postman oder führen Sie sie direkt mit Newman aus.

## Anwendungsfälle

- Schnelles Bereitstellen von Test-Collections für QA-Teams direkt aus dem API-Entwurf.
- Generierung von Collection-Dateien für CI/CD-Pipelines zur automatisierten Ausführung mit Newman.
- Onboarding von Frontend-Entwicklern mit vorkonfigurierten Beispiel-Requests und dynamischen Parametern.

## Häufig gestellte Fragen

### Welche OpenAPI- und Swagger-Formate werden unterstützt?

Das Tool verarbeitet OpenAPI 3.0.x, 3.1.x sowie Swagger 2.0 sowohl in JSON als auch in YAML.

### Wie wird die Basis-URL der API in Postman übernommen?

Der erste Server-Eintrag wird als Collection-Variable {{baseUrl}} angelegt. Zusätzliche Server werden als baseUrl_2 nummeriert und Trailing-Slashes werden automatisch entfernt.

### Wie werden Sicherheitsschemata wie Bearer oder API-Keys umgesetzt?

Sicherheitsschemata werden als Collection-Auth definiert und verweisen auf passende Platzhaltervariablen wie {{bearerToken}} oder {{apiKey}}.

### Was unterscheidet die Ordnerstrategien nach Pfaden und nach Tags?

Die Pfad-Strategie erstellt verschachtelte Ordner anhand der URL-Segmente, während die Tag-Strategie Endpunkte nach den deklarierten OpenAPI-Tags gruppiert.

### Werden Cookie-Parameter in die Collection übernommen?

Nein, da Postman Collections Cookie-Parameter nicht nativ in Anfragen abbilden können, werden diese mit einem Hinweis verworfen.

## Ähnliche Tools

- [Visualisierer fuer Umgebungs-Konfigurationsunterschiede](https://elysiatools.com/de/tools/environment-config-diff-visualizer): Vergleicht JSON-, YAML-, TOML- und ENV-Konfigurationen zwischen Umgebungen und hebt Drift, fehlende Keys und Bereinigungshinweise hervor.
- [OpenAPI-zu-TypeScript-Generator](https://elysiatools.com/de/tools/openapi-to-typescript-generator): Konvertiert OpenAPI- oder Swagger-Spezifikationen in JSON/YAML in TypeScript-API-Typen, Anfrageparameter und Antwortmodelle mit konfigurierbarem Ausgabeformat und Namensstil
- [Bild-Palette zu Design-Tokens](https://elysiatools.com/de/tools/image-to-design-tokens): Extrahiert dominante Farben per k-Means und exportiert sie als CSS-/SCSS-Variablen, Tailwind-Config oder JSON-Tokens mit Namen und Farbskala
- [Bereichsdiagramm-Generator](https://elysiatools.com/de/tools/range-chart-generator): Erstellen Sie Bereichsdiagramme zur Visualisierung von Min-Max-Wertbereichen mit Medianmarkierungen und Ausreißer-Erkennung
- [JSON-Schema-zu-Zod-Konverter](https://elysiatools.com/de/tools/json-schema-to-zod-schema-converter): Konvertiert JSON/YAML-Definitionen von JSON Schema in direkt nutzbaren Zod-Code fuer TypeScript-Projekte, inklusive verschachtelter Objekte, Arrays, Enums und gaengiger Validierungsregeln
- [PDF-QR/Barcode-Etiketten](https://elysiatools.com/de/tools/pdf-qr-barcode-labels): Erstellt PDF-Etikettenstapel mit QR und Barcode
- [BOM-Zeichen-Entferner](https://elysiatools.com/de/tools/data-bom-remover): BOM (Byte Order Mark) Zeichen aus Text- und Dateiinhalten entfernen. Perfekt zum Bereinigen von Textdateien mit Codierungsproblemen.
- [Datenbereichs-Begrenzer](https://elysiatools.com/de/tools/data-range-limiter): Numerische Werte auf angegebene Bereiche begrenzen durch Clipping, Filtern oder Markieren von Werten außerhalb des Bereichs. Perfekt für Datenqualitätskontrolle.

## Beispiele

- [OpenAPI/Swagger Beispiele](https://elysiatools.com/de/samples/openapi-swagger): Umfassende API-Dokumentationsbeispiele mit OpenAPI 3.0 und Swagger-Spezifikationen für RESTful-Services
- [Distributed Tracing Beispiele](https://elysiatools.com/de/samples/distributed-tracing-samples): Umfassende Beispiele für verteiltes Tracing mit Jaeger, OpenTelemetry und modernen Observability Tools
- [Parcel Bundling-Tool](https://elysiatools.com/de/samples/parcel): Parcel Null-Konfigurations-Bundler-Beispiele einschließlich Projekt-Setup, Plugins und erweiterter Konfiguration
- [pnpm Package Manager Beispiele](https://elysiatools.com/de/samples/pnpm): Schneller, platzsparender Paketmanager Beispiele inklusive Monorepo-Management, Workspace-Konfiguration, und fortgeschrittene Workflows

## Verwandte Inhalte

- [Tools fur JSON-Austausch und Format-Ubersetzung](https://elysiatools.com/de/hubs/json-convert): Vergleiche JSON-Konvertierungswerkzeuge fur CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN und ahnliche strukturierte Formate in einem Hub.
- [Werkzeuge fur JSON-Inspektion, Diff und Transformation](https://elysiatools.com/de/hubs/json-utility): Bunde JSON-Formatierung, Diff, Pfad-Inspektion, Schema-Prufung, Merge und Transformation in einem Hub fur API- und Daten-Workflows.
- [Generatoren fur JSON-Schemas, Mock-Daten und API-Fixtures](https://elysiatools.com/de/hubs/json-generate): Gebundelte Werkzeuge fur JSON-Schema-Generierung, Aufbau von Mock-Payloads und Vorbereitung von API-Fixtures in einem Hub.
- [JSON-Formatierungs-, Diff- und Normalisierungs-Tools](https://elysiatools.com/de/hubs/json-format): Vergleichen Sie JSON-Formatierung, Diff, Log-Review, Konfigurationsvergleich und Datennormalisierung in einem Hub für lesbare und überprüfbare JSON-Workflows.
