Punti salienti
- 01Alimentato da Ajv, il validatore JSON Schema JavaScript più utilizzato — ciò che passa qui passa in Node.js, Fastify e nella maggior parte delle toolchain JS.
- 02Segnala ogni errore di validazione contemporaneamente (modalità allErrors), non solo il primo fallimento.
- 03Ogni errore include il percorso JSON Pointer al campo che non supera la validazione per una navigazione rapida.
- 04Sia lo schema che i dati vengono eseguiti interamente nel tuo browser — nulla viene caricato.
Perché Validare JSON Rispetto a uno Schema?
JSON Schema è il modo standard per descrivere la struttura di un documento JSON — campi obbligatori, tipi consentiti, vincoli di valore, strutture di oggetti annidati. Validare rispetto a uno schema prima che un payload raggiunga la produzione cattura mancate corrispondenze di tipo, campi obbligatori mancanti e violazioni di vincoli in anticipo, quando sono economici da correggere.
I casi d'uso più comuni sono il test dei corpi di richiesta e risposta dell'API, la validazione dei file di configurazione, il controllo degli oggetti di esempio OpenAPI e la verifica delle esportazioni di dati rispetto a una struttura nota. Il validatore di Handytool utilizza Ajv — la libreria JSON Schema JavaScript di fatto, utilizzata all'interno di Node.js stesso — quindi i risultati qui corrispondono a ciò che il tuo backend vedrà.
Come Validare JSON Rispetto a uno Schema
- 01
Incolla il tuo Schema JSON
Incolla lo schema nel pannello sinistro. Può essere uno schema Draft 7 o 2019-09 o 2020-12 con type, properties, required, items, anyOf, allOf — qualsiasi parola chiave standard supportata da Ajv.
- 02
Incolla i tuoi dati JSON
Incolla il documento dati che desideri validare nel pannello destro. Questa è l'istanza — un corpo di richiesta API, un oggetto di configurazione, un record di esportazione o un singolo esempio dalla tua specifica OpenAPI.
- 03
Fai clic su Valida
Ajv esegue la validazione con allErrors: true, il che significa che raccoglie ogni fallimento piuttosto che fermarsi al primo.
- 04
Rivedi l'elenco degli errori
Ogni errore mostra il percorso JSON Pointer al valore che non supera la validazione (ad es. /user/email), la parola chiave che non supera la validazione (type, required, minimum) e un messaggio leggibile dall'uomo. Correggi ognuno e rivalida.
Cosa Validano gli Sviluppatori Con JSON Schema
- 01Corpi di richiesta API REST — conferma che un payload corrisponda alla forma prevista dell'endpoint prima di inviare.
- 02Oggetti di esempio della specifica OpenAPI — valida ogni esempio rispetto al componente schema inline.
- 03File di configurazione — assicurati che le chiavi obbligatorie siano presenti e i valori siano del tipo corretto.
- 04Record della pipeline di dati — rileva la deriva strutturale tra i produttori e i consumatori di dati.
- 05Payload di invio del modulo — verifica che la validazione frontend rispecchi i vincoli dello schema backend.
- 06Corpi webhook di terze parti — conferma che lo schema documentato corrisponda al payload effettivo.
Validazione Privata, Nessun Server Richiesto
Ajv viene eseguito interamente nel tuo browser. Né lo schema né i dati vengono inviati a nessun server — puoi validare in sicurezza gli schemi che descrivono strutture di dati interne e oggetti dati che contengono valori di campo sensibili.
Il validatore supporta i draft JSON Schema 6, 7, 2019-09 e 2020-12. Il draft più comune in circolazione è Draft 7, che copre tutte le parole chiave quotidiane: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not e $ref.
Domande Frequenti sul Validatore JSON Schema
Quali draft di JSON Schema sono supportati?
Ajv supporta i draft 6, 7, 2019-09 e 2020-12. Draft 7 è il più comune nelle basi di codice esistenti e copre tutte le parole chiave standard.
Perché il mio schema $ref non si risolve?
Gli URL $ref esterni non vengono recuperati in questo strumento solo browser. Incorpora tutti gli schemi referenziati utilizzando $defs e puntatori JSON locali come #/$defs/MyType.
Il mio schema o i miei dati vengono caricati su un server?
No. Ajv viene eseguito interamente nel tuo browser — sia lo schema che i dati rimangono sul tuo dispositivo.
Posso usarlo per validare una specifica OpenAPI 3?
Puoi validare i componenti dello schema individuale e gli oggetti di esempio. La validazione dell'intero documento OpenAPI richiede un validatore OpenAPI dedicato che comprenda il meta-schema della specifica.
Perché vedo più errori invece di solo il primo?
Il validatore è configurato con allErrors: true, che fa sì che Ajv raccolga ogni fallimento piuttosto che fermarsi al primo. Questo è intenzionale — puoi correggere tutti i problemi in un solo passaggio piuttosto che fare ripetuti tentativi di validazione.