Generatore di Schema JSON
Genera automaticamente uno Schema JSON dai dati JSON
Input JSON
Schema generato
Cos'è un Generatore di Schema JSON?
Uno Schema JSON descrive la struttura di un documento JSON: quali campi esistono, i loro tipi e quali sono obbligatori. Questo strumento analizza il tuo JSON e genera automaticamente uno schema corrispondente. Prende il tuo JSON come input ed emette uno schema valido che puoi usare per la validazione, la documentazione o la generazione di codice.
La generazione avviene nel tuo browser. Niente viene inviato a un server. Lo schema generato è un punto di partenza — potresti aver bisogno di modificarlo per aggiungere vincoli, campi obbligatori o valori enum.
Come usare questo strumento
Incolla o carica JSON
Incolla il JSON che vuoi descrivere nell'editor. Usa Esempio o Carica se necessario. Il generatore inferisce i tipi dai valori (string, number, boolean, array, object).
Rivedi lo schema
Il pannello di destra mostra lo schema generato. Può includere type, properties, required e schemi annidati per gli oggetti. Puoi modificarlo manualmente se necessario.
Copia o scarica
Usa <strong>Copia</strong> o <strong>Scarica</strong> per ottenere lo schema. Per validare JSON rispetto allo schema, usa il Validatore JSON o una libreria come <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>.
Esempi di Schema JSON
Generazione di uno schema da un JSON di esempio. Esempio con tema telecomunicazioni:
Input JSON
Schema generato
Quando usare lo schema generato
Lo schema generato è un punto di partenza. Cattura la struttura dei dati di esempio ma potrebbe essere troppo rigido o troppo permissivo. Potrebbe essere necessario aggiungere array required, regolare i tipi o aggiungere enum per i valori consentiti. La documentazione di JSON Schema spiega il vocabolario completo. Per la documentazione delle API, strumenti come OpenAPI possono fare riferimento agli schemi JSON.
Domande frequenti
Posso usare questo schema per validare JSON?
Questo strumento genera solo lo schema. Per validare, usa il Validatore JSON o una libreria come Ajv nel tuo codice.
E se il mio JSON ha forme diverse?
Il generatore inferisce dal campione che fornisci. Se il tuo JSON può avere più forme (es. campi opzionali), lo schema potrebbe richiedere modifiche manuali. Usa oneOf o anyOf per le varianti.
I dati vengono inviati da qualche parte?
No. La generazione viene eseguita nel browser.
Quale bozza di JSON Schema viene usata?
Lo strumento può usare draft-07 o draft-2020-12. Controlla il $schema nello schema generato per verificare la versione. La specifica JSON Schema ha i dettagli.
Posso usarlo per le risposte API?
Sì. Incolla una risposta API tipica. Lo schema generato descriverà quella struttura. Puoi poi usarlo in OpenAPI/Swagger o per la documentazione.
Strumenti correlati
Scopri di più su json-schema.org e JSON Schema Learn. Per la validazione nel codice, vedi Ajv. Per JSON: json.org, MDN, RFC 8259. Per la documentazione API: OpenAPI.