Fügen Sie Anfragedaten ein oder wählen Sie eine Datei und das Zielformat. Prüfen Sie Methoden, URLs und Header vor dem Kopieren oder Herunterladen.
Läuft lokal in deinem BrowserDer Konverter liest eingefügten Text oder eine lokale Datei. Er ruft nie einen API-Endpunkt auf und importiert keine entfernte Sammlung.
| Name | Methode | URL | Header |
|---|---|---|---|
| Fügen Sie eine Sammlung oder Anfrage ein, um die lokale Vorschau zu sehen. | |||
Prüfen Sie die erzeugte Ausgabe vor dem Speichern. Authentifizierungswerte verbleiben nur in diesem Browser-Tab; ersetzen Sie sie vor dem Teilen durch sichere Variablen.
Fünf Eingaben – Postman-Sammlungen, Insomnia-Exporte, Bruno-Anfragen, OpenAPI- oder Swagger-Dokumente und cURL-Befehle – und vier Ausgaben: OpenAPI 3.0.3, Postman v2.1, cURL und Fetch-JavaScript. Alle zwanzig Paare aus Eingabe und Ausgabe wurden für diesen Text mit echten Anfragedaten ausgeführt.
Die Konvertierung ist JavaScript im Browser. Bei geöffnetem Netzwerk-Panel erzeugte die Umwandlung einer 2,2 MB großen Sammlung keine einzige Anfrage: Weder Sammlung noch URL oder Zugangsdaten werden hochgeladen, und kein in der Eingabe genannter Endpunkt wird aufgerufen.
Postman-Ordner werden zu Namen der Form „Ordner / Anfrage“, und Werte aus der Variablenliste der Sammlung werden in URLs, Header und Bodies eingesetzt; ein in der Datei definiertes {{baseUrl}} wird also zu einer echten Adresse. Ein Platzhalter, den die Datei nie definiert, bleibt unverändert stehen, statt geraten zu werden.
Swagger-2.0-Dokumente werden über host, basePath und schemes gelesen: Parameter mit in: body werden nach dem angegebenen consumes-Medientyp zu einem Request-Body, Parameter mit in: formData zu Multipart-Formulardaten. Aus Bruno-Dateien werden Methodenblock, URL und Headerblock gelesen, andere Blöcke der Datei bleiben unberücksichtigt.
Der Parser akzeptiert -X/--request, -H/--header, -d/--data/--data-raw/--data-binary/--data-urlencode, -F/--form/--form-string, -u/--user, -A/--user-agent, -b/--cookie, -e/--referer und --url und fügt Zeilen mit abschließendem Backslash zusammen, bevor er beginnt. Aus -u user:pass wird ein Authorization: Basic-Header, aus -A, -b und -e werden User-Agent, Cookie und Referer.
Uploads überstehen die Umwandlung: -F "file=@photo.png" setzt die Methode wie curl auf POST und kommt als Dateifeld in Postman, als -F-Argument in cURL oder als FormData-Eintrag in Fetch zurück. Ein von der Platte gelesener Body bleibt ein Dateiverweis – -d @payload.json wird als --data @payload.json neu geschrieben, während --data-raw @payload.json seine wörtliche Bedeutung behält.
Eine Pfadvorlage übersteht den Rundlauf: /items/{id} bleibt beim Konvertieren von einem OpenAPI-Dokument in ein anderes /items/{id} und wird nicht zu /items/%7Bid%7D. Eine Abfragezeichenfolge wird zu Query-Parametern mit den Werten aus der URL, und ein Pfad mit zwei Methoden wird zu einem Pfadelement mit zwei Operationen.
Ein OpenAPI-Dokument kann nicht zwei Operationen für denselben Pfad und dieselbe Methode enthalten, deshalb werden wiederholte Paare zusammengeführt und die Statuszeile nennt die Anzahl. Anfragen an verschiedene Hosts behalten ihren eigenen Server, der erste Host wird zum Server des Dokuments.
Das erzeugte OpenAPI enthält Beispielwerte statt Schemas: Ein Body wird zu einem Beispielobjekt, und jede Operation erhält eine Platzhalterantwort 200 Successful response. Es ist ein bearbeitbares Ausgangsdokument, keine geprüfte Spezifikation, und es erfindet keine Antwortmodelle, die in der Quelle fehlten.
Header- und Authentifizierungswerte werden unverändert übernommen; deshalb bittet die Seite darum, sie vor dem Teilen durch Variablen zu ersetzen. Eine fehlgeschlagene Konvertierung löscht das vorherige Ergebnis, statt es stehen zu lassen, damit ein altes Dokument nie für das aktuelle gehalten wird. Große Eingaben bleiben schnell: 5.000 Anfragen in 2,2 MB brauchten etwa 65 ms, 100 Anfragen in 43 KB etwa 10 ms.