Validatore di JSON Schema
Convalida JSON rispetto a uno JSON Schema e visualizza ogni errore con il percorso del valore non valido e la regola violata, compresi formati come email e data-ora. Funziona nel browser.
Input
Output
Leggimi
Che cos’è uno schema JSON?
Uno schema JSON descrive l’aspetto che dovrebbe avere un documento JSON: quali proprietà contiene un oggetto, quali sono obbligatorie, il tipo di ogni valore, gli intervalli e le lunghezze consentiti, i pattern e i formati, come gli indirizzi email o le date. Le API, i file di configurazione e i generatori di moduli usano gli schemi per controllare i dati prima di considerarli attendibili, mentre OpenAPI li usa per descrivere i corpi delle richieste e delle risposte.
Come usare il validatore
- Incolla o digita lo schema JSON nella prima casella.
- Incolla o digita i dati JSON da controllare nella seconda casella.
- Il risultato appare mentre digiti: o il JSON è valido, oppure vengono elencati tutti gli errori, con il percorso del valore non conforme, la parola chiave dello schema violata e una breve spiegazione.
- Ogni valore non conforme viene evidenziato nei dati. Fai clic su un errore per scorrere fino al valore corrispondente nei dati, oppure fai clic su un’evidenziazione per trovare l’errore nell’elenco.
Il campo Versione dello schema indica rispetto a quale bozza di JSON Schema sono stati controllati i dati.
Bozze supportate
La parola chiave $schema dello schema seleziona la bozza:
- Bozza 2020-12:
https://json-schema.org/draft/2020-12/schema - Bozza 2019-09:
https://json-schema.org/draft/2019-09/schema - Bozza 7:
http://json-schema.org/draft-07/schema# - Bozza 6:
http://json-schema.org/draft-06/schema#
Se lo schema non contiene $schema, viene controllato come bozza 7. La bozza 4 e quelle precedenti non sono supportate. Prima, lo schema stesso viene controllato rispetto al meta-schema della propria bozza: quindi un errore di battitura come "type": "strin" viene segnalato come schema non valido, anziché essere ignorato. Le annotazioni come title, description ed examples sono ammesse, così come le parole chiave sconosciute alla bozza, per esempio le annotazioni x- personalizzate: vengono ignorate.
Come leggere gli errori
- I percorsi sono scritti in JSONPath e iniziano con
$, che rappresenta l’intero documento:$.ingredients[1].unitindica la proprietàunitdel secondo ingrediente. - Una proprietà obbligatoria mancante viene segnalata sull’oggetto che dovrebbe contenerla, indicando il nome della proprietà nel messaggio.
- Una proprietà aggiuntiva non consentita dallo schema viene segnalata indicando il nome della proprietà.
- Per
enumeconst, il messaggio elenca i valori consentiti. - Con
anyOfeoneOf, ogni ramo non valido aggiunge i propri errori, seguiti da un errore relativo alla parola chiave stessa: quindi un singolo valore errato può generare diversi errori.
I messaggi di errore provengono dalla libreria Ajv e sono in inglese.
Formati
Vengono controllati anche i valori con un format: email, uri, uri-reference, date, time, date-time, duration, uuid, ipv4, ipv6, hostname, regex, json-pointer e altri. I formati sconosciuti al validatore vengono ignorati, come consentito dalla specifica JSON Schema.
Riferimenti
$ref funziona per le definizioni all’interno dello stesso schema, come #/$defs/address o #/definitions/address. I riferimenti ad altri file o URL non vengono recuperati: uno schema che ne richiede uno viene segnalato come non valido, indicando il riferimento che non è stato possibile risolvere.
Come funziona
Lo strumento esegue la validazione con Ajv, un validatore JSON Schema ampiamente utilizzato, e controlla i formati con ajv-formats. Tutto viene eseguito nel browser: lo schema e i dati non vengono mai caricati online.
Funzionalità
- Supporto per le bozze di JSON Schema 6, 7, 2019-09 e 2020-12, selezionate tramite
$schema - Elenco di tutti gli errori, con percorso, parola chiave e messaggio
- Valori non conformi evidenziati nei dati, con possibilità di fare clic per scorrere fino ad essi
- Controllo dei formati di email, URI, date, UUID, indirizzi IP e altro
- Controllo dello schema rispetto al relativo meta-schema
- Riga e colonna degli errori di sintassi JSON
- Esecuzione nel browser