Abbozzare un contratto dei dati
Parti da una risposta API o file di scambio e confronta la struttura con la documentazione applicativa. Aggiungi vincoli che il campione non dimostra.
Generatore JSON Schema
Analizza un documento JSON e deduce automaticamente tipi, proprietà, array e campi obbligatori.
- Appunti
- Esporta
Dati non inviati
JSON Schema generato
Questo strumento ti è stato utile?
Come funziona questo strumento?
Crea una prima versione di JSON Schema da un documento JSON rappresentativo. Il generatore identifica tipi, oggetti annidati, liste e proprietà osservate per descrivere una struttura riutilizzabile con draft 2020-12. L’output è una proposta da rivedere, non la scoperta automatica di ogni regola API. Nessun documento viene caricato su un servizio: il browser analizza il campione e mostra uno schema JSON da leggere, copiare o esportare.
Le stringhe diventano string, i booleani boolean e null null. Gli interi osservati sono distinti dagli altri numeri. Gli oggetti producono properties; gli array inferiscono items da tutti gli elementi forniti, non solo dal primo. Varianti di tipo possono essere rappresentate con anyOf.
Si combinano le proprietà degli oggetti nello stesso array. Una chiave mancante in alcune voci non entra in required; una chiave sempre presente viene inclusa. La regola riflette soltanto il campione. Una risposta che contiene un campo facoltativo nel contratto reale non permette di indovinarne la possibile assenza.
Gli oggetti usano additionalProperties: false, rifiutando chiavi mai osservate anche quando l’applicazione le accetterebbe. Rivedi questa scelta prima di validare risposte future. Un array vuoto non informa sui futuri elementi: lo schema lascia aperta la loro forma senza inventare un tipo.
L’inferenza non deduce formati email, espressioni regolari, limiti numerici o elenchi esaustivi di valori. Una data rimane stringa. Osservare 1 non dimostra minimum: 1 o const: 1. I numeri usano la rappresentazione del browser; conserva identificatori grandi come stringhe quando il contratto lo prevede.
Come usare questo strumento
Scegli un campione utile
Incolla JSON valido con struttura completa. Preferisci dati anonimizzati con forme rilevanti a grandi quantità di valori ripetuti.
Genera e controlla le proprietà
Rivedi tipi inferiti, required e chiusura degli oggetti. Un valore null è diverso da una proprietà assente.
Completa e prova il contratto
Aggiungi formati o limiti giustificati e prova dati validi e non validi prima dell’integrazione. Il download contiene uno schema JSON, non un modulo TypeScript.
Casi d’uso
Riconoscere varianti di un array
Includi campi omessi, presenti e null per distinguere obbligatorietà e tipi. Campioni diversi offrono una base più rappresentativa.
Preparare validazione riutilizzabile
Usa lo schema con un validatore che supporti draft e parole chiave. La generazione non installa controlli automatici nell’applicazione.
Esempi
Inferire intero e booleano
id diventa integer e active boolean. Entrambi sono obbligatori perché presenti nell’oggetto; additionalProperties rifiuta chiavi ulteriori.
Input
{"id":1,"active":true}Risultato
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"active": {
"type": "boolean"
}
},
"required": [
"id",
"active"
],
"additionalProperties": false
}Considerare tutti gli elementi dell’array
id compare in entrambi gli oggetti e resta obbligatorio. name compare solo nel secondo: è una proprietà nota ma facoltativa.
Input
[{"id":1},{"id":2,"name":"Ada"}]Risultato
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}
}Consigli e buone pratiche
- Non trasformare un valore osservato in costante applicativa senza altre prove. Un campione non documenta tutti i valori consentiti.
- Prova una risposta con un campo nuovo per decidere se additionalProperties: false rispetta la tua politica di compatibilità.
- Mantieni proprietà omesse e valori null in casi di test distinti: esprimono regole diverse.
- Usa JSON in TypeScript per ottenere anche interfacce TypeScript o schemi Zod invece di copiare manualmente le strutture.
Fonti e riferimenti
- JSON Schema Draft 2020-12 (si apre in una nuova scheda), JSON SchemaPagina in inglese
Domande frequenti
Viene analizzato soltanto il primo elemento dell’array?
No. Tutti gli elementi forniti partecipano all’inferenza. Le proprietà si combinano e le assenze influenzano required. Rimane un’analisi dei campioni, non una previsione di dati futuri sconosciuti.
Perché è obbligatorio un campo facoltativo della mia API?
Non è mai mancato nei campioni pertinenti. Rimuovilo da required secondo il contratto reale oppure aggiungi un oggetto rappresentativo privo della chiave.
Perché vengono rifiutati campi aggiuntivi?
Gli oggetti sono chiusi con additionalProperties: false. Modifica la regola se ammetti nuove proprietà e decidi esplicitamente prima di validare dati in evoluzione.
Il risultato garantisce la validità di tutti i dati?
No. Descrive forme osservate e richiede revisione applicativa. Aggiungi vincoli pertinenti e usa un validatore compatibile con draft e parole chiave effettivamente utilizzati.
Strumenti correlati
Continua con questi strumenti
Strumenti simili o complementari a questo.
Strumenti simili
Valida un documento JSON con uno schema e individua con precisione ogni errore.
SviluppoIn evidenzaUsa questo strumento
Genera interfacce TypeScript, tipi, schemi Zod o JSON Schema da un esempio JSON.
SviluppoUsa questo strumento
Formatta, minifica e valida un documento JSON per renderlo più leggibile o compatto.
SviluppoIn evidenzaUsa questo strumento