JSON Schema zu OpenAPI Konverter – kostenlos online

Q: 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 immer noch vom OAS 3.0-orientierten Konverter (z. B. nullable) – keine vollständige Neufassung des OAS 3.1-Schemaobjekts. Siehe Optionen.

Konvertieren Sie das JSON-Schema (Draft-07 / 2020-12) in ein minimales OpenAPI-Dokument – wählen Sie openapi 3.0.3 oder 3.1.0 (Versionsfeld; Schemaobjekte bleiben OAS 3.0-orientiert). 100 % im Browser, nichts hochgeladen.

0 chars · 0 B

OpenAPI

Teilen Sie dieses Tool:

JSON Schema

OpenAPI Dokument

Die Konvertierung erfolgt in Ihrem Browser – es wird nichts 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. • $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). • 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-orientierten Konverter (z. B. nullable); Wählen Sie 3.1.0, wenn Ihre Toolchain diese Versionszeichenfolge erwartet.

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" },
  "Pfade": {},
  "Komponenten": { "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 immer noch vom OAS 3.0-orientierten Konverter (z. B. nullable) – keine vollständige Neufassung des OAS 3.1-Schemaobjekts. 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. OpenAPI YAML wird vom Rückwärtswandler und den OpenAPI-Werkzeugen unterstützt.

Verwandte Tools?

Konvertieren Sie mit OpenAPI zurück in JSON Schema, validieren Sie Daten mit JSON Schema Validator oder überprüfen Sie nur die Syntax JSON mit JSON Validator.

Weitere API- und Schema-Tools in diesem Cluster

Formatieren Sie OpenAPI OpenAPI validieren Flusen OpenAPIJSON Schema zu OpenAPIOpenAPI bis JSON Schema JSON Schema-Validator GraphQL validieren

Suchen Sie nach Konvertern, Encodern, Formatierern und Minifiern an einem Ort? Hub für Entwicklertools Öffnen Sie den kuratierten Entwicklertools-Katalog.