Generatore JSON Schema Online
Genera JSON Schema da qualsiasi JSON. Perfetto per la validazione delle API e la documentazione.
Perché usarlo
Dai JSON a schemi pronti per le API
Compatibile
Genera schemi compatibili con Draft 7, OpenAPI 3.x e le principali librerie di validazione.
Privato
Il JSON viene elaborato interamente nel tuo browser. Nessun dato viene trasmesso.
Preciso
Tipi inferiti correttamente, strutture annidate e array supportati.
Istantaneo
Lo schema appare subito, senza attese né registrazione.
Come funziona
Tre passaggi, senza complicazioni
Incolla il tuo JSON
Incolla un oggetto o array JSON valido. Lo strumento analizza la struttura e inferisce i tipi di dato.
Rivedi lo schema generato
Lo JSON Schema viene generato automaticamente con i tipi corretti, le proprietà richieste e la struttura annidata.
Copia o scarica lo schema
Usa lo schema per validare i dati in ingresso nelle tue API, generare documentazione o configurare strumenti di test.
FAQ
Hai delle domande?
JSON Schema è uno standard che descrive la struttura e i vincoli di un documento JSON. Definisce i tipi di dato di ogni campo (stringa, numero, booleano, array, oggetto), quali proprietà sono obbligatorie e le regole di validazione come valori minimi o pattern di formato. Viene usato per validare dati in ingresso nelle API, generare documentazione e configurare editor con autocompletamento.
Lo schema viene inferito dai dati forniti: se un campo è null in tutti i record del campione, il tipo risulterà null anche se in realtà accetta stringhe. Per JSON di produzione è sempre consigliabile revisionare lo schema generato e aggiungere manualmente i vincoli mancanti, come i pattern per le email o i valori ammessi per i campi enum.
Le versioni più diffuse sono Draft 4, Draft 6, Draft 7 e le recenti Draft 2019-09 e Draft 2020-12. La maggior parte degli strumenti di validazione nelle API REST e nelle librerie come Ajv, jsonschema (Python) e Newtonsoft.Json (.NET) supporta Draft 7. OpenAPI 3.x usa un sottoinsieme di JSON Schema Draft 7.
Sì. JSON Schema è alla base di OpenAPI (Swagger): ogni oggetto nei path di un'API OpenAPI è descritto tramite JSON Schema. Partendo dallo schema generato puoi costruire la documentazione interattiva con Swagger UI, ReDoc o Stoplight, e configurare la validazione automatica dei payload nelle richieste e risposte.
Quando un array contiene oggetti con campi diversi tra gli elementi, lo schema risultante usa anyOf o oneOf per descrivere le varianti possibili. In alternativa, se le differenze sono minori, le proprietà aggiuntive vengono marcate come non obbligatorie. La revisione manuale è consigliata per array eterogenei.
JSON Schema: storia, versioni e uso nelle API moderne
JSON Schema nacque intorno al 2009 come proposta informale per descrivere la struttura dei documenti JSON, prendendo ispirazione da XML Schema. I primi draft formali arrivarono nel 2013 con il Draft 4, adottato rapidamente dall'ecosistema delle API REST. La specifica è mantenuta dalla community su json-schema.org e non fa capo a un ente di standardizzazione formale come ISO o W3C, ma ha una larghissima adozione industriale.
Con l'ascesa di OpenAPI (ex Swagger), JSON Schema diventò lo standard de facto per descrivere i modelli di dati nelle API HTTP. OpenAPI 3.0 e 3.1 usano un sottoinsieme di JSON Schema con alcune estensioni proprietarie. La versione 2020-12 ha allineato ulteriormente la specifica alle esigenze moderne, introducendo vocabolari modulari, il costrutto prefixItems per gli array e una semantica più precisa per unevaluatedProperties.
Oggi JSON Schema è usato ben oltre le API: è alla base degli schemi di configurazione di Visual Studio Code (che usa schemi per il completamento automatico in JSON), dei form builder come React JSON Schema Form, e di strumenti ETL che validano i record prima dell'inserimento nei database. La generazione automatica a partire da dati reali accelera enormemente la creazione della documentazione e la configurazione dei pipeline di validazione.