Curso de JSON: Estructuración y Validación de Esquemas de Datos

Índice General

1. ¿Qué es JSON y cuál es su propósito?
2. Evolución Histórica frente a XML
3. Tipos de Datos Soportados en la Sintaxis
4. Validación Estructural mediante JSON Schema
5. Caso Práctico: Validación de Esquemas utilizando Python

1. ¿Qué es JSON y cuál es su propósito?

JSON (JavaScript Object Notation) es un formato de texto plano ligero diseñado para el intercambio de datos entre servidores y aplicaciones web. Basado en una estructura de pares clave-valor, es completamente independiente del lenguaje de programación utilizado, siendo fácilmente legible tanto por seres humanos como por computadoras.

Los archivos de datos guardados bajo este estándar deben portar obligatoriamente la extensión corporativa .json.

2. Evolución Histórica frente a XML

Antes de la adopción masiva de JSON, la industria dependía de lenguajes de marcado complejos como XML (eXtensible Markup Language), el cual requería una gran sobrecarga de etiquetas, volviendo las transferencias de red lentas y difíciles de parsear.

Diferencia de Legibilidad y Peso de Datos

• Sintaxis Tradicional en XML:

  <persona><nombre>Juan</nombre><edad>30</edad><profesion>Ingeniero</profesion></persona>

• Sintaxis Optimizada en JSON:

  {"nombre": "Juan", "edad": 30, "profesion": "Ingeniero"}

3. Tipos de Datos Soportados en la Sintaxis

JSON permite anidar estructuras complejas y soporta de forma nativa los siguientes tipos de datos:

• Strings (Cadenas): Deben encerrarse estrictamente entre comillas dobles ("").
• Numbers (Números): Enteros o decimales de punto flotante.
• Booleans: Valores lógicos verdaderos o falsos (true / false).
• Null: Representación explícita de un valor vacío o nulo.
• Arrays (Listas): Colecciones ordenadas de datos encerradas entre corchetes ([]).
• Objects (Objetos): Colecciones de pares clave-valor delimitadas por llaves ({}).

Ejemplo Completo de Documento JSON Complejo

{
  "nombre": "Juan",
  "edad": 30,
  "profesion": "Ingeniero",
  "casado": false,
  "hijos": ["Ana", "Luis"],
  "direccion": {
    "calle": "Calle Falsa 123",
    "ciudad": "Springfield",
    "pais": "USA"
  },
  "telefonos": [
    {
      "tipo": "casa",
      "numero": "555-1234"
    },
    {
      "tipo": "movil",
      "numero": "555-5678"
    }
  ]
}

4. Validación Estructural mediante JSON Schema

Para garantizar que un archivo JSON recibido en una API posea los campos requeridos, los tipos de datos correctos y rangos válidos antes de procesarlos, se utiliza un contrato denominado JSON Schema.

Ejemplo de Esquema de Validación con Restricciones Avanzadas

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string"
    },
    "edad": {
      "type": "integer"
    },
    "activo": {
      "type": "boolean"
    },
    "anio_registro": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2026
    }
  },
  "required": ["nombre", "edad", "activo"]
}

5. Caso Práctico: Validación de Esquemas utilizando Python

El siguiente script en Python demuestra cómo automatizar la validación de un documento de datos contra un esquema predefinido utilizando la librería profesional jsonschema:

import jsonschema
from jsonschema import validate

# 1. El documento de datos real (Payload recibido)
documento_json = {
    "nombre": "Juan",
    "edad": 30,
    "activo": True
}

# 2. El contrato estructural formal (JSON Schema)
esquema_json = {
    "type": "object",
    "properties": {
        "nombre": {"type": "string"},
        "edad": {"type": "integer"},
        "activo": {"type": "boolean"}
    },
    "required": ["nombre", "edad", "activo"]
}

# 3. Bloque de control y validación de excepciones
try:
    validate(instance=documento_json, schema=esquema_json)
    print("Métrica Exitosa: El documento JSON es completamente válido según el contrato del esquema.")
except jsonschema.exceptions.ValidationError as error_validacion:
    print("Falla Estructural Detectada. Detalles de la anomalía:")
    print(error_validacion.message)