OpenAPI zu JSON Schemakonverter – kostenlos online

Q: Was ist, wenn kein Root-Schema vorhanden ist?

Alle Schemas landen unter $defs (oder definitions, wenn Draft-07 ausgewählt ist) ohne erfundene Stammtypen/Eigenschaften. Ein Schema mit dem Namen Root erhält außerdem einen $ref der obersten Ebene für diesen Eintrag.

Extrahieren Sie OpenAPI 3.0–3.2 Components.schemas in JSON Schema – Standard Draft 2020-12 ($defs), optional Draft-07 (Definitionen). Browserlokal, kein Upload.

0 chars · 0 B

Entwurf

Teilen Sie dieses Tool:

OpenAPI Dokument

JSON Schema

Die Konvertierung erfolgt in Ihrem Browser – es wird nichts hochgeladen.

Laden…

OpenAPI bis JSON Schemadokumentation

Extrahieren Sie OpenAPI Components.schemas in JSON Schema (2020-12 oder Draft-07).

Hinweise des Entwicklers

• OpenAPI 3.0-Schemata konvertieren über @openapi-contrib/openapi-schema-to-json-schema. • OpenAPI 3.1 / 3.2 verwenden einen Best-Effort-Streifen von Nur-OAS-Schlüsselwörtern. • Standardausgabe: $schema 2020-12 + $defs; optionale Draft-07-Neuzuordnung ($schema + definitionen + #/definitions refs). • Leere Components.schemas → Fehler. • Externe $ref abgelehnt. • Maximale Eingabe 512 KiB.

Optionen

Zielentwurf

2020-12 (Standard) gibt $schema + $defs aus. Draft-07 wird dem Draft-07-$schema URI, Definitionen statt $defs und #/definitions/… refs zugeordnet – nur eine strukturelle Umbenennung; Nur Schlüsselwörter für 2020-12 werden nicht umgeschrieben.

Anwendungsfälle

• OpenAPI-Modelle als eigenständiges JSON-Schema wiederverwenden. • Extrahierte Schemata in den JSON Schema Validator einspeisen. • Schemaformen außerhalb eines vollständigen OpenAPI-Dokuments unterscheiden.

Beispiele

OpenAPI YAML → JSON Schema $defs

Vor

openapi: „3.0.3“
Infos:
  Titel: Haustiere
  Version: 1.0.0
Pfade: {}
Komponenten:
  schemas:
    Foo:
      Typ: Objekt
      Eigenschaften:
        ID:
          Typ: Zeichenfolge
    Bar:
      Typ: Objekt
      Eigenschaften:
        Name:
          Typ: Zeichenfolge

Nach

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "Foo": { ... },
    „Bar“: { ... }
  }
}

Leere Schemata wurden abgelehnt

Vor

openapi: „3.0.3“
Infos:
  Titel: t
  Version: „1“
Pfade: {}
Komponenten:
  Schemata: {}

Nach

Fehler: leere Components.schemas

OpenAPI bis JSON Schema-FAQ

Häufige Fragen

Ist die 3.1-Konvertierung identisch mit Draft-07?

Nein. Die OpenAPI 3.1/3.2-Konvertierung ist ein Best-Effort-Keyword-Strip. Die Standardausgabe ist Draft 2020-12 ($defs). Wählen Sie Draft-07 für eine strukturelle Neuzuordnung (definitionen + Draft-07 $schema) – keine vollständige Neufassung des Schlüsselworts. Siehe Optionen.

Was ist, wenn kein Root-Schema vorhanden ist?

Alle Schemas landen unter $defs (oder definitions, wenn Draft-07 ausgewählt ist) ohne erfundene Stammtypen/Eigenschaften. Ein Schema mit dem Namen Root erhält außerdem einen $ref der obersten Ebene für diesen Eintrag.

Verwandte Tools?

Konvertieren Sie umgekehrt mit JSON Schema in OpenAPI oder validieren Sie die OpenAPI-Quelle mit Validate OpenAPI.

Weitere API- und Schema-Tools in diesem Cluster

Formatieren Sie OpenAPI OpenAPI validieren Flusen OpenAPI JSON Schema zu OpenAPIOpenAPI bis JSON SchemaJSON 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.