Com Utilitzar JSON Schema per Validar les Teves Dades

By Equip de JSONValidator.dev • 2025-07-04

Què és un JSON Schema?

Un JSON Schema és una manera estàndard de descriure l’estructura, els camps obligatoris i els tipus de valor de les teves dades JSON. Pensa-hi com un contracte o un pla per a com hauria de ser un JSON vàlid. El JSON Schema està escrit en format JSON, fent-lo tant llegible per màquines com fàcil d’editar.

El JSON Schema no serveix només per validar, també és útil per generar codi, documentació d’APIs i completat automàtic en editors.

Per què Validar amb un Esquema?

  • Evitar errors detectant dades no vàlides o incompletes abans que causin problemes.
  • Garantir la coherència de dades entre diferents equips, aplicacions o APIs.
  • Generar documentació automàticament a partir dels esquemes.
  • Ajudar als editors i eines a oferir millor completat automàtic i ajuda integrada.
Fins i tot un esquema senzill pot detectar errors comuns, estalviant hores de depuració després.

Un Exemple Senzill: Esquema Bàsic

Aquí tens un objecte JSON bàsic, seguit d’un esquema mínim que valida la seva estructura:

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

Aquest esquema assegura que l’objecte ha de tenir un 'name' (com a cadena) i una 'age' (com a nombre).

Com Escriure un Esquema Personalitzat

Pots definir regles avançades al teu esquema: restringir valors dels camps, definir objectes anidats o establir valors mínims/màxims. Aquí tens un exemple que valida un array de productes:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Comença amb esquemes simples i vés-los ampliant; usa validadors en línia per verificar cada pas.

Com Utilitzar JSONValidator.dev per a la Validació d’Esquemes

  1. Enganxa les teves dades JSON a l’editor principal.
  2. Enganxa el teu JSON Schema a l’editor d’esquema a sota.
  3. Fes clic a Valida JSON contra aquest esquema.
  4. Revisa els resultats de la validació, amb qualsevol error ressaltat i explicat.
Tota la validació es fa al navegador — les teves dades mai surten del teu dispositiu.

Com Resoldre Errors de Validació d’Esquema

Les causes comunes dels errors de validació inclouen:

  • Falta un camp obligatori a les teves dades.
  • El tipus de valor no coincideix amb l’esquema (per exemple, cadena en lloc de nombre).
  • L’esquema mateix és invàlid o conté errors tipogràfics.
Revisa amb cura els missatges d’error: sovint t’indicaran el camp exacte i el desajustament de tipus.

Conclusió

La validació amb JSON Schema és una manera potent de fer les teves dades robustes i sense errors. Prova de crear un esquema per a les teves pròpies dades amb el nostre Generador de JSON Schema gratuït i valida-ho en temps real!