Validatore Schema JSON

Questo strumento supporta JSON Schema Draft-07, Draft 2019-09 e Draft 2020-12 attraverso la libreria Ajv. La maggior parte delle funzionalità comuni degli schemi sono supportate.

Sì! JSON Schema supporta oggetti e array profondamente nidificati. Puoi definire proprietà ed elementi a qualsiasi livello di nidificazione, con regole di validazione individuali per ogni campo.

Lo strumento verifica prima che il tuo schema sia esso stesso un JSON Schema valido. Se lo schema presenta errori, questi verranno segnalati prima di tentare di validare i dati.

type (string, number, object, array, boolean, null), properties con schemi annidati, required che elenca le chiavi obbligatorie, enum per insiemi fissi di valori, pattern per stringhe vincolate da espressioni regolari, e i controlli di intervallo minimum/maximum e minLength/maxLength. additionalProperties: false rende gli oggetti più restrittivi rispetto alle chiavi extra. Insieme coprono la gran parte delle regole di validazione delle API.

Nel JSON Schema moderno, format è un'annotazione per impostazione predefinita, non un'asserzione automatica - i validatori la applicano solo quando sono configurati per farlo, cosa che la specifica 2020-12 ha reso esplicita con un vocabolario separato per le asserzioni di formato. Usa pattern o una parola chiave personalizzata quando l'applicazione del vincolo deve essere garantita, e tratta format come metadato di interoperabilità negli altri casi.

$ref che punta a #/$defs/address fa riferimento a un frammento di schema sotto $defs e valida rispetto ad esso ovunque venga usato - è il meccanismo di deduplicazione. La bozza 2020-12 ha rinominato definitions in $defs e ha formalizzato $dynamicRef per le strutture ricorsive come gli alberi di commenti. I riferimenti possono puntare anche a documenti esterni, anche se è più comune il bundling locale.

allOf richiede che ogni sottoschema sia valido - un'intersezione, usata per comporre uno schema di base con vincoli aggiuntivi. anyOf ne richiede almeno uno - un'unione, usata per payload polimorfici. oneOf ne richiede esattamente uno; se due o zero sottoschemi risultano validi, la validazione fallisce, un comportamento più severo di quanto ci si aspetti e la causa abituale di errori sorprendenti con schemi sovrapposti.

2020-12 ha diviso la specifica in vocabolari negoziabili separatamente (validation, annotation, format-assertion), ha rinominato definitions in $defs, ha semplificato exclusiveMinimum in un semplice numero e ha sostituito la vecchia parola chiave items con prefixItems più items. La maggior parte degli strumenti supporta entrambe; draft-07 resta la più diffusa, ma 2020-12 è lo standard pubblicato attuale.