Come Usare JSON Schema per Validare i Tuoi Dati

By Team JSONValidator.dev • 2025-07-04

Cos’è un JSON Schema?

Un JSON Schema è un metodo standardizzato per descrivere la struttura, i campi obbligatori e i tipi di valori nei tuoi dati JSON. Pensalo come un contratto o un progetto di ciò che un JSON valido dovrebbe essere. Lo schema JSON è scritto in JSON stesso, rendendolo sia leggibile dalle macchine sia facile da modificare.

JSON Schema non serve solo per la validazione: è utile anche per la generazione di codice, la documentazione API e l’auto-completamento negli editor.

Perché Validare con uno Schema?

  • Evita bug intercettando dati invalidi o mancanti prima che causino problemi.
  • Garantisci la coerenza dei dati tra team, applicazioni o API differenti.
  • Genera automaticamente la documentazione a partire dagli schemi.
  • Aiuta editor e strumenti a fornire auto-completamento e assistenza in linea migliori.
Anche uno schema semplice può individuare errori comuni, risparmiandoti ore di debug in seguito.

Un Esempio Semplice: Schema di Base

Ecco un oggetto JSON di base, seguito da uno schema minimo che ne valida la struttura:

{
  "name": "Alice",
  "age": 30
}
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

Questo schema assicura che l’oggetto debba avere un 'name' (stringa) e un 'age' (numero).

Come Scrivere uno Schema Personalizzato

Puoi definire regole avanzate nel tuo schema: limitare valori di campo, definire oggetti annidati, impostare numeri minimi/massimi. Ecco un esempio che convalida un array di prodotti:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Parti dal semplice: costruisci il tuo schema passo dopo passo e usa validatori online per controllare ogni fase.

Come Usare JSONValidator.dev per la Validazione dello Schema

  1. Incolla i tuoi dati JSON nell’editor principale.
  2. Incolla il tuo JSON Schema nell’editor dello schema sottostante.
  3. Clicca su Valida JSON contro questo Schema.
  4. Esamina i risultati della validazione, con eventuali errori evidenziati e spiegati.
Tutta la validazione avviene nel tuo browser: i dati non lasciano mai il tuo dispositivo.

Risoluzione degli Errori di Validazione dello Schema

Le cause comuni di errori di validazione includono:

  • Un campo obbligatorio manca nei tuoi dati.
  • Un tipo di valore non corrisponde allo schema (es. stringa invece di numero).
  • Lo schema stesso è invalido o contiene errori di battitura.
Controlla attentamente i messaggi di errore: spesso indicano esattamente quale campo è errato e quale tipo non corrisponde.

Conclusione

La validazione con JSON Schema è un modo potente per rendere i tuoi dati robusti e senza errori. Prova a creare uno schema per i tuoi dati con il nostro gratuito Generatore di JSON Schema e validalo in tempo reale!