Cum să folosești JSON Schema pentru a valida datele tale

By Echipa JSONValidator.dev • 2025-07-04

Ce este un JSON Schema?

JSON Schema este o metodă standardizată de a descrie structura, câmpurile obligatorii și tipurile de valori din datele tale JSON. Gândește-l ca pe un contract sau plan al aspectului pe care trebuie să-l aibă un JSON valid. JSON Schema este scris chiar în JSON, ceea ce îl face atât lizibil de mașină, cât și ușor de editat.

JSON Schema nu servește doar pentru validare — este util și pentru generarea de cod, documentația API și completarea automată în editoare.

De ce să validezi cu o schemă?

  • Previne erorile prin identificarea datelor invalide sau lipsă înainte să cauzeze probleme.
  • Asigură consistența datelor între echipe, aplicații sau API-uri diferite.
  • Generează automat documentația pornind de la scheme.
  • Ajută editoarele și instrumentele să ofere completare automată și asistență inline mai bune.
Chiar și o schemă simplă poate prinde greșeli comune, economisind ore întregi de depanare ulterior.

Un exemplu simplu: Schema de bază

Iată un obiect JSON simplu, urmat de o schemă minimală care îi validează structura:

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

Această schemă asigură că obiectul trebuie să conțină un câmp 'name' (tip șir de caractere) și un câmp 'age' (tip număr).

Cum să scrii o schemă personalizată

Poți defini reguli avansate în schema ta: să restricționezi valorile câmpurilor, să definești obiecte imbricate sau să specifici valori minime/maxime pentru numere. Iată un exemplu care validează un array de produse:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Începe simplu: construiește schema pe parcurs și folosește validatoare online pentru a verifica fiecare pas.

Cum să folosești JSONValidator.dev pentru validarea schemelor

  1. Lipește datele tale JSON în editorul principal.
  2. Lipește JSON Schema în editorul dedicat schemelor de mai jos.
  3. Apasă pe Validate JSON Against This Schema.
  4. Revizuiește rezultatele validării, cu erorile evidențiate și explicate.
Toată validarea se face în browserul tău — datele tale nu părăsesc niciodată dispozitivul.

Depanarea erorilor de validare a schemelor

Motive comune pentru erorile de validare includ:

  • Un câmp obligatoriu lipsește din datele tale.
  • Tipul unei valori nu corespunde cu schema (de exemplu, șir în loc de număr).
  • Schema însăși este invalidă sau conține greșeli de scriere.
Verifică atent mesajele de eroare — acestea indică de cele mai multe ori câmpul exact și nepotrivirea de tip.

Concluzie

Validarea cu JSON Schema este o metodă puternică pentru a face datele tale robuste și fără erori. Încearcă să creezi o schemă pentru propriile date cu ajutorul generatorului nostru gratuit JSON Schema Generator și valideaz-o în timp real!