JSON Schema zu OpenAPI Konverter – kostenlos online

Konvertieren Sie ein JSON-Schema (Draft-07 / 2020-12) in ein minimales OpenAPI-Dokument. Wählen Sie openapi 3.0.3 oder 3.1.0 für das Versionsfeld. Schemaobjekte bleiben OAS-3.0-orientiert. Läuft zu 100 % im Browser, nichts wird hochgeladen.

Laden…
JSON Schema zu OpenAPI Dokumentation
Konvertieren Sie das JSON-Schema in ein minimales OpenAPI-Dokument (openapi 3.0.3- oder 3.1.0-Versionsfeld).

Hinweise des Entwicklers

Konvertiert Draft-07 / 2020-12 JSON-Schema in OpenAPI-Schemaobjekte über @openapi-contrib/json-schema-to-openapi-schema. Die Ausgabe ist ein minimales OpenAPI-Dokument (Info, leere Pfade, Components.schemas) mit openapi 3.0.3 (Standard) oder 3.1.0. Ausgabeformat JSON (Standard) oder YAML wählbar – Ergebnis direkt in eine bestehende OpenAPI-Spec-Datei einfügen. Live-Konvertierung bei Paste/Sample; explizites Konvertieren (⌘↵) für manuelle Bearbeitung; Monaco JSON-Eingabe + Shiki-Ausgabe. $defs/Definitionen werden zu benannten Schemata; Ein Nur-Root-Schema wird zu Root (oder Titel). Externe / http(s) $ref werden abgelehnt – nie abgerufen. Nur JSON-Eingabe (YAML abgelehnt) – wählbar ist nur das Ausgabeformat. Maximale Eingabe 512 KiB.

Optionen

OpenAPI-Version
Setzt das Dokumentfeld openapi auf 3.0.3 (Standard) oder 3.1.0. Schemaobjekte stammen weiterhin vom OAS-3.0-Konverter (z. B. nullable). Wählen Sie 3.1.0, wenn Ihre Toolchain diese Versionsangabe erwartet.
Ausgabeformat
Wählen Sie JSON (Standard) oder YAML für das erzeugte OpenAPI-Dokument. OpenAPI akzeptiert beide Serialisierungen. YAML eignet sich zum Einfügen in eine bestehende YAML-Spec-Datei, JSON für Tools, die JSON erwarten.

Anwendungsfälle

Verwandeln Sie ein JSON-Schemamodell in einen OpenAPI-components.schemas-Starter. Nach der Konvertierung in Validate OpenAPI verketten. Geben Sie einen OpenAPI-Stub mit einer einzelnen Datei aus einem vorhandenen Schema frei.

Beispiele

JSON Schema $defs → OpenAPI components.schemas

Vor

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Pet": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } } }

Nach

{ "openapi": "3.0.3", "info": { "title": "Converted from JSON Schema", "version": "1.0.0" }, "paths": {}, "components": { "schemas": { "Pet": { ... } } } }

Externe $ref abgelehnt

Vor

{ "$ref": "https://example.com/schemas/pet.json" }

Nach

Fehler: externe $ref wird nicht unterstützt

JSON Schema zu OpenAPI FAQ

Häufige Fragen

Welche OpenAPI-Version wird produziert?

Wählen Sie in der Symbolleiste 3.0.3 (Standard) oder 3.1.0. Dadurch wird das Dokumentfeld openapi festgelegt. Schemaobjekte stammen weiterhin vom OAS-3.0-Konverter (z. B. nullable), es ist also keine vollständige Neufassung der Schemaobjekte für OAS 3.1. Siehe Optionen.

Werden externe $ref unterstützt?

Nein. External und http(s) $ref erzeugen einen schwerwiegenden Fehler. Es sind nur interne #/…-Referenzen innerhalb des eingefügten Dokuments zulässig.

Kann ich YAML einfügen?

Nein. Auf der Seite des JSON-Schemas fügen Sie nur JSON ein. Der Konverter in Gegenrichtung und die OpenAPI-Tools unterstützen auch OpenAPI-YAML. Das erzeugte OpenAPI-Dokument kann JSON oder YAML sein: Wählen Sie es über die Option Ausgabeformat in der Symbolleiste.

Verwandte Tools?

Für die Rückrichtung nutzen Sie OpenAPI zurück in JSON Schema. Daten prüfen Sie mit dem JSON Schema Validator, reine JSON-Syntax mit dem JSON Validator.

API & Schemata

OpenAPI Tools zum Formatieren, Validieren und Flusen Ihrer Spezifikationen.

Weitere Werkzeugkategorien entdecken