Validació amb JSON Schema

Validació JSON Schema

JSON Schema és un llenguatge per definir l'estructura i les restriccions de les dades JSON.

• Permet validar que un document JSON compleix amb un conjunt de regles predefinides, assegurant la coherència de les dades.

• És especialment útil en aplicacions web i APIs per garantir que les dades intercanviades són correctes i esperades.

JSON SCHEMA

Exemple d'un JSON que compleix amb un JSON Schema

{
  "Persones": [
    {
      "Nom": "Anna",
      "Edat": 30
    },
    {
      "Nom": "Pere",
      "Edat": 25
    }
  ]
}

Exemple de fitxer JSON Schema corresponent

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "Persones": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Nom": { "type": "string" },
          "Edat": { "type": "integer", "minimum": 0, "maximum": 120 }
        },
        "required": ["Nom", "Edat"]
      }
    }
  },
  "required": ["Persones"]
}

Elements Bàsics en JSON Schema

Definir una propietat simple

"Nom": { "type": "string" }

Definir un objecte

"Persona": {
  "type": "object",
  "properties": {
    "Nom": { "type": "string" },
    "Edat": { "type": "integer" }
  },
  "required": ["Nom", "Edat"]
}

Tipus de dades bàsics en JSON Schema

• string → Cadena de text

• integer → Enter

• number → Número decimal

• boolean → Cert o fals (true / false)

• array → Llista de valors

• object → Estructura amb propietats

• null → Valor nul

Definir atributs en objectes

"Persona": {
  "type": "object",
  "properties": {
    "Nom": { "type": "string" },
    "id": { "type": "integer" }
  },
  "required": ["Nom"]
}

Restriccions de valors

"Edat": {
  "type": "integer",
  "minimum": 0,
  "maximum": 120
}

Enumeracions (valors predefinits)

"Color": {
  "type": "string",
  "enum": ["Vermell", "Verd", "Blau"]
}

Definir propietats opcionals o amb múltiples ocurrències

• Opcional (required no especificat)

• Repetit com a array

"Persones": {
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "Nom": { "type": "string" },
      "Edat": { "type": "integer" }
    },
    "required": ["Nom", "Edat"]
  }
}

📖 Documentació sobre JSON Schema

Si busques informació sobre JSON Schema, aquí tens alguns recursos útils:

🌍 Web oficial

• JSON Schema – Documentació oficial, guies d’ús i especificacions.

• Què és json schema?

📚 Altres fonts útils

• MDN (Mozilla Developer Network) – Explicació general de JSON i recursos addicionals.

🛠 Eines per validar esquemes JSON

• JSON Schema Validator

• JSONLint