Generatore classe C# → JSON Schema

Input Codice C#

Caricamento editor…

Output JSON Schema

Impostazioni

Seleziona quale classe o record deve essere trattata come root durante la generazione dello schema.

Il parsing avviene interamente nel tuo browser. Il sorgente non lascia mai la pagina.

Incolla i tuoi DTO C# per produrre un JSON Schema istantaneamente.

Supporta classi, struct, record, annotazioni, nullable reference types e collezioni generiche.

Come convertire classi e record C# in JSON Schema – guida passo‑passo

Questo convertitore online classe C# → JSON Schema ti aiuta a generare JSON Schema da modelli reali (DTO, struct e classi) per validare payload, condividere contratti e generare JSON mock.

  1. Passo 1 – Incolla il sorgente C#

    • Incolla i modelli che vuoi documentare nell’editor di sinistra.
    • Includi i tipi referenziati nello stesso snippet in modo che lo schema possa generare le definizioni.
    • Usa il pulsante Esempio per caricare un esempio e vedere il formato atteso.
  2. Passo 2 – Seleziona il Classe root (se necessario)

    • Se vengono rilevate più definizioni, scegli la root che corrisponde al payload della tua API.
    • Lo schema di output è costruito attorno alla root selezionata e può includere definizioni aggiuntive per i tipi referenziati.
  3. Passo 3 – Controlla l’output JSON Schema

    • Verifica tipi, campi richiesti vs opzionali e strutture annidate di oggetti/array.
    • Cerca definitions e $ref quando i tuoi modelli fanno riferimento ad altri modelli.
    • Copia o scarica lo schema per validazione, documentazione o sviluppo schema‑first.
  4. Passo 4 – Valida o genera JSON mock

    • Fai clic su Genera dati mock per aprire il generatore di mock con lo schema pre‑caricato.
    • Valida payload reali rispetto allo schema per intercettare breaking change in anticipo.
    • Se usi composizione avanzata dello schema (ad esempio anyOf/oneOf/allOf), verifica il risultato con un validatore completo come Ajv.

Nota sul supporto delle keyword dello schema

Gli schemi generati possono includere $ref e possono essere modificati per includere anyOf, oneOf, o allOf. Per schemi complessi, usa un validatore JSON Schema completo e dereferenzia prima della generazione dei mock se necessario.

Strumenti correlati per JSON Schema e generazione di codice

Usa questi strumenti per validare schemi, generare payload mock, formattare esempi JSON e mantenere allineati codice e contratti.

Domande frequenti

Quali costrutti C# sono supportati?

Il parser riconosce classi, struct, record (con primary constructor), auto‑property, backing field, enum e attributi come JsonPropertyName, JsonProperty e DataMember(Name=...). Rispetta nullable reference types, campi opzionali, collezioni e dizionari direttamente nello schema generato.

Come vengono mappati i tipi su JSON Schema?

Primitivi come string, bool, int/double/decimal, DateTime/DateOnly/Guid vengono mappati al tipo/formato schema più vicino. Array, List<T>, IEnumerable<T>, Dictionary<TKey, TValue>, Nullable<T> e T? diventano costrutti array/oggetto/opzionali. I simboli non riconosciuti ricadono su reference quando corrispondono a un’altra classe o enum.

Funziona con versioni C# e serializer diversi?

Sì. Sono gestite funzionalità moderne come record, init‑only setter, nullable reference types, annotazioni System.Text.Json e attributi classici Newtonsoft.Json. Lo strumento gira nel browser, quindi puoi incollare DTO proprietari in sicurezza.

Come genero JSON mock?

Dopo aver creato lo schema, fai clic su "Genera dati mock" per aprire il Mock Generator con lo schema pre‑caricato. Configura locale, numero elementi array e campi opzionali per produrre subito payload realistici per documentazione o test.

Generatore classe C# → JSON Schema | JSONSwiss