Swift Struct → JSON-Schema-Generator

Swift-Code Eingabe

Editor wird geladen…

JSON Schema Ausgabe

Einstellungen

Wählen Sie, welches Struct als JSON-Schema-Root behandelt werden soll.

Das Parsing läuft vollständig im Browser. Ihr Code verlässt die Seite nicht.

Fügen Sie Ihre Swift-Structs ein, um sofort JSON Schema zu erzeugen.

Unterstützt Optional, Arrays, verschachtelte Objekte und einfache Enums.

So konvertieren Sie Swift-Structs zu JSON Schema – Schritt-für-Schritt

Dieser Online-Konverter (Swift struct → JSON Schema) hilft Ihnen, JSON Schema aus echten Modellen (DTOs, structs, classes) zu generieren, um Payloads zu validieren, Verträge zu teilen und Mock JSON zu erzeugen.

  1. Schritt 1 – Swift-Quelle einfügen

    • Fügen Sie die Modelle, die Sie dokumentieren möchten, in den linken Editor ein.
    • Fügen Sie referenzierte Typen im selben Snippet hinzu, damit definitions generiert werden können.
    • Mit Beispiel laden Sie ein Beispiel und sehen das erwartete Eingabeformat.
  2. Schritt 2 – Root-Struct auswählen (falls nötig)

    • Wenn mehrere Definitions erkannt werden, wählen Sie die Root-Definition, die zu Ihrem API-Payload passt.
    • Das Output-Schema wird um die gewählte Root-Definition aufgebaut und kann zusätzliche Definitions enthalten.
  3. Schritt 3 – JSON-Schema-Ausgabe prüfen

    • Prüfen Sie Typen, required vs. optionale Felder und verschachtelte Objekt-/Array-Strukturen.
    • Achten Sie auf definitions und $ref wenn Modelle andere Modelle referenzieren.
    • Schema kopieren oder herunterladen – für Validierung, Dokumentation oder schema-first Entwicklung.
  4. Schritt 4 – Validieren oder Mock JSON generieren

    • Klicken Sie auf Mock-Daten generieren um den Mock-Generator mit vorbefülltem Schema zu öffnen.
    • Validieren Sie reale Payloads gegen Ihr Schema, um Breaking Changes früh zu erkennen.
    • Wenn Sie fortgeschrittene Komposition nutzen (z. B. anyOf/oneOf/allOf), prüfen Sie das Ergebnis mit einem vollständigen Validator wie Ajv.

Hinweis zum Keyword-Support

Generierte Schemas können $ref enthalten und bei Bedarf um anyOf, oneOf, oder allOfergänzt werden. Für komplexe Schemas nutzen Sie einen vollständigen JSON-Schema-Validator und dereference vor der Mock-Generierung, falls nötig.

Verwandte JSON-Schema- und Code-Generierungs-Tools

Nutzen Sie diese Tools, um Schemas zu validieren, Mock-Payloads zu erzeugen, JSON-Beispiele zu formatieren und Code und Verträge synchron zu halten.

Häufig gestellte Fragen

Welche Swift-Syntax wird unterstützt?

Structs mit typisierten Properties, Optional, Arrays und verschachtelten Objekten. Fügen Sie mehrere zusammengehörige Structs ein, um definitions zu erzeugen.

Wie werden Swift-Typen gemappt?

String/Int/Double/Bool werden auf JSON-Schema-Typen gemappt; Arrays werden zu Arrays mit items; Optional wird als optional behandelt. Einfache Enums können zu enum werden.

Kann ich das Root-Struct auswählen?

Ja. Nutzen Sie die Settings, um bei mehreren Types das Root-Struct zu wählen.

Wie erzeuge ich Mock-Daten aus dem Schema?

Nach der Schema-Generierung klicken Sie auf "Mock-Daten generieren", um den Mock-Generator mit vorbefülltem Schema zu öffnen.

Swift Struct → JSON-Schema-Generator | JSONSwiss