Generatore classe TypeScript → JSON Schema

Input Codice TypeScript

Caricamento editor…

Output JSON Schema

Impostazioni

Seleziona quale interfaccia/tipo deve essere trattata come root del JSON Schema.

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

Incolla i tuoi tipi TypeScript per produrre JSON Schema istantaneamente.

Supporta interfacce, type alias, campi pubblici di classi, modifier optional/readonly e union type.

Come convertire interfacce, tipi e classi TypeScript in JSON Schema – guida passo‑passo

Questo convertitore online interfaccia TypeScript → 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 TypeScript

    • 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 Tipo 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

Quale sintassi TypeScript è supportata?

Vengono parsate interfacce, type alias e classi con campi pubblici. Sono gestite proprietà opzionali, modifier readonly, chiavi string‑literal, union type, array, Record e reference annidate. Commenti e decorator sono ignorati, quindi puoi incollare DTO direttamente dal progetto.

Come funziona la mappatura dei tipi?

I tipi primitivi (string, number, boolean, bigint, Date) mappano a primitivi JSON Schema con formati appropriati. Array (Foo[] o Array<Foo>), Record<string, T> e forme tipo dizionario diventano array/oggetti nello schema. Union type che includono null/undefined marcano automaticamente il campo come opzionale.

Posso usarlo per classi oltre che per interfacce?

Sì. Finché la classe definisce campi pubblici (o proprietà readonly) con annotazioni di tipo, verrà convertita in JSON Schema. Lo strumento gira interamente nel browser, quindi il codice non lascia la macchina.

Come ottengo JSON mock dallo schema?

Dopo la generazione dello schema, fai clic su "Genera dati mock" per aprire il Mock Generator con lo schema pre‑caricato. Configura locale, dimensioni array e campi opzionali per produrre payload di esempio istantaneamente.

Generatore classe TypeScript → JSON Schema | JSONSwiss