C# Class → JSON-Schema-Generator

C#-Code Eingabe

Editor wird geladen…

JSON Schema Ausgabe

Einstellungen

Wählen Sie, welche Klasse/Record 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 C#-Modelle ein, um sofort JSON Schema zu erzeugen.

Unterstützt classes, records, Collections, verschachtelte Objekte und nullables.

So konvertieren Sie C#-Klassen und Records zu JSON Schema – Schritt-für-Schritt

Dieser Online-Konverter (C# class → 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 – C#-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-Typ 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 C#-Syntax wird unterstützt?

Klassen und Records mit öffentlichen Properties, primitiven Typen, Arrays, Listen, verschachtelten Objekten und Enums. Attribute wie JsonPropertyName können helfen, Namen an Ihren Serializer anzupassen.

Wie werden Nullables und optionale Felder behandelt?

Nullable Felder und optionale Properties werden als optional markiert. Typen wie List<T> oder Dictionary<string, T> werden als Arrays/Objects abgebildet.

Kann ich mehrere Typen auf einmal konvertieren?

Ja. Fügen Sie mehrere verwandte Typen ein und wählen Sie den Root-Typ in den Settings. Alles läuft im Browser.

Wie erzeuge ich Mock JSON?

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

C# Class → JSON-Schema-Generator | JSONSwiss