Validator di JSON Schema

Parole chiave supportate

Core: type, enum, const, multipleOf, maximum, minimum, exclusiveMaximum, exclusiveMinimum, maxLength, minLength, pattern, maxItems, minItems, uniqueItems, maxContains, minContains, maxProperties, minProperties, required, dependentRequired.

Composizione: allOf, anyOf, oneOf, not.

Applicatori: properties, patternProperties, additionalProperties, items, prefixItems, contains, propertyNames.

Condizionali: if, then, else, dependentSchemas.

Riferimenti: $ref, $defs, $id, $anchor.

Formati (con validazione quando abilitata): date-time, date, time, duration, email, hostname, ipv4, ipv6, uri, uuid, regex.

Uscita degli errori

FAIL  /user/email        format            "not-an-email" non è un "email" valido
FAIL  /user/age          minimum           -3 è inferiore al minimo 0
FAIL  /orders/0/total    type              "42" non è di tipo "number"
FAIL  /                  required          proprietà richiesta "shippingAddress" mancante

Ogni errore include il percorso e la parola chiave che ha fallito, rendendo veloce la localizzazione nel tuo editor.

Differenze tra le bozze che colpiscono

Imposta la bozza corretta; validare uno schema di bozza-04 come 2020-12 interpreterà male id e alcune altre sottigliezze.

Flussi di lavoro tipici

• Test di contratto API: prima di un deploy, esegui lo schema OpenAPI generato/aggiornato contro risposte campione reali.
• Rafforzamento della configurazione: valida ogni configurazione YAML/JSON in CI contro uno schema prima di unire.
• Ingestione dei dati: rifiuta i payload che non corrispondono alla forma attesa in anticipo, con un chiaro messaggio di errore.

Errori comuni

• Dimenticare l’applicazione di format. Per impostazione predefinita, la maggior parte dei validatori tratta i formati sconosciuti come solo annotazioni. Abilita la validazione di formato rigorosa per rifiutare effettivamente email e date errate.
• Uso eccessivo di oneOf. Se due rami di oneOf si sovrappongono, il documento fallirà (deve corrispondere esattamente a uno). Usa anyOf o schemi discriminatori.
• Schemi rigidi con additionalProperties: false. Aggiungere un nuovo campo opzionale diventa una modifica di rottura. Omettilo a meno che tu non voglia davvero un oggetto chiuso.