Bidirektionaler OpenAPI-3.0- und 3.1-Konverter

Bidirektionaler OpenAPI-3.0- und 3.1-Konverter: Aktualisiert die Root-Version auf 3.1.0 und konvertiert die alte OpenAPI 3.0 „nullable: true“ in „type: [string, 'null']“.

Tool wird geladen...

Über bidirektionaler openapi-3.0- und 3.1-konverter

Bidirektionaler OpenAPI-3.0- und 3.1-KonverterBidirektionaler OpenAPI-3.0- und 3.1-Konverter: Aktualisiert die Root-Version auf 3.1.0 und konvertiert die alte OpenAPI 3.0 „nullable: true“ in „type: [string, 'null']“.

Funktionsweise dieses Tools

Konvertiert OpenAPI 3.0/3.1 Verträge in Model Context Protocol (MCP) Werkzeuge und validiert JSON Schema Entwürfe.

Verarbeitungs-Pipeline und technische Systemarchitektur

  1. Lexikalische Datenerfassung und Normalisierung im lokalen Arbeitsspeicher-Puffer.
  2. Strukturelle Syntaxvalidierung und Verifikation von Domänen-Invarianten und Grenzwerten.
  3. Deterministische algorithmische Transformation und mathematische Präzisionsberechnung.
  4. Serialisierung der geprüften Ausgabe, Integritätsvalidierung und Bereitstellung von Diagnose-Badges.

Beispiel und praktische Anwendung

Praxisnahes Anwendungsszenario: JSON-OpenAPI-Dokument auf Ziel 3.1 aktualisieren.

Beispieleingabe:

{"openapi":"3.0.3","info":{"title":"CZOA","version":"1"},"paths":{}}

Algorithmische Verarbeitung: Root-Version und Draft-2020-12-Dialekt setzen.

Beispielausgabe:

"openapi": "3.1.0"; "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema"

Grenzen und Sonderfälle

Für 3.1 ersetzt er rekursiv `nullable: true` durch type mit `null` und ändert boolesche exklusive Grenzen mit numerischem Grenzwert. Für 3.0 werden type-Arrays mit null wieder nullable.

Browser-Verarbeitung und Datenschutz

Die Tool-Funktion ist dafür ausgelegt, Eingaben im Browser zu verarbeiten, ohne sie absichtlich an einen CZOA-Verarbeitungsserver zu senden. Anfragen für Website-Ressourcen, Analyse oder Werbung sind davon getrennt. Browser, Erweiterungen und verwaltete Gerätesoftware liegen außerhalb dieser Grenze.

Lokale Ausführung und Verifizierungsmethodik

Die Verarbeitung der Tool-Nutzlast ist so konzipiert, dass sie lokal im Browser über JavaScript oder Web Workers erfolgt. Anfragen für Website-Ressourcen, Analyse oder Werbung sind davon getrennt. Vertraulichkeit, Wiederholbarkeit und Latenz hängen von der Browser-Umgebung ab und werden nicht absolut garantiert.

Technische Normen und Referenzspezifikationen

Inhaltlich verantwortlich: CZOA Tools · Zuletzt geprüft: 2026-09-15 · Prüfmethodik

Anwendung

  1. Geben Sie Daten ein oder wählen Sie im Arbeitsbereich eine unterstützte Datei.
  2. Prüfen Sie die Bedienelemente und wählen Sie verfügbare Parameter, Einheiten, Formate oder Bereiche.
  3. Klicken Sie auf die Aktionsschaltfläche oder lesen Sie die sofortige Berechnung ab.
  4. Prüfen Sie Hinweise und Ergebnis, bevor Sie es kopieren oder exportieren.

Häufig gestellte Fragen

Wie wählt OpenAPI Version Converter das Ziel?+

Er liest ein JSON- oder YAML-Objekt. Nur das zweite Feld exakt `3.0` wählt `3.0.3`; jeder andere Wert wählt `3.1.0`. JSON ergibt formatiertes JSON, YAML ergibt YAML.

Was zeigt die 3.1-Fixture?+

Ein JSON mit `openapi: 3.0.3` wird zu `openapi: 3.1.0` und erhält `jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema`. Die Fixture prüft diese Felder, nicht die ganze Spezifikation.

Welche Schema-Rewrites gibt es?+

Für 3.1 ersetzt er rekursiv `nullable: true` durch type mit `null` und ändert boolesche exklusive Grenzen mit numerischem Grenzwert. Für 3.0 werden type-Arrays mit null wieder nullable.

Was wird nicht migriert oder validiert?+

Er verlangt keine Root-Keys, validiert Quelle oder Ergebnis nicht, löst keine Referenzen, bewahrt keine YAML-Kommentare oder Aliase, meldet keinen Verlust, begrenzt keine Tiefe und deckt nicht alle OpenAPI-Differenzen ab.