JSON - Explicación Completa y Ejemplos

¿Qué es JSON?

JSON (JavaScript Object Notation) es un formato sencillo, rápido y ligero para almacenar e intercambiar datos. Actualmente es el estándar más utilizado en APIs, sistemas web, servicios móviles y bases de datos NoSQL.

Fue creado por Douglas Crockford y se popularizó por su simplicidad en comparación con XML, siendo adoptado rápidamente por plataformas como Google, Facebook, Twitter y miles de servicios web.

Características principales

Fácil de leer para humanos y máquinas.
Compatible con cualquier lenguaje de programación.
Ideal para aplicaciones web, móviles y microservicios.
Basado en estructuras de datos simples.
Puede representar datos complejos de forma ordenada.
Ligero, lo que reduce el tráfico en redes.

Historia de JSON

JSON fue propuesto en 2001 por Douglas Crockford como una alternativa más simple y clara a XML. En 2013, JSON se estandarizó oficialmente como ECMA-404 y posteriormente como RFC 8259.

Hoy en día es el formato dominante para intercambio de datos en internet gracias a su sencillez.

Estructura de JSON

JSON se compone de:

Objetos: pares clave/valor dentro de llaves { }
Arreglos: listas dentro de corchetes [ ]
Tipos primitivos: string, number, boolean, null

Ejemplo de estructura básica

{ "persona": { "nombre": "Luis Fernandez", "edad": 30, "activo": true, "intereses": ["música", "viajes", "programación"] } }

Tipos de Datos en JSON

String: "Hola mundo"
Number: 24, 3.14
Boolean: true o false
null: valor vacío
Array: ["rojo", "verde"]
Object: {"clave": "valor"}

Ejemplos Avanzados de JSON

1. Información de una tienda

{ "tienda": { "nombre": "TechZone", "ubicacion": "Madrid", "productos": [ { "id": 1, "nombre": "Laptop", "precio": 999.99 }, { "id": 2, "nombre": "Teclado", "precio": 49.90 } ], "abierto": true } }

2. Ejemplo con anidación profunda

{ "universidad": { "nombre": "UNETEC", "carreras": [ { "nombre": "Ingeniería en Software", "materias": [ { "nombre": "Programación I", "profesor": "Ana Ruiz", "horarios": ["Lunes", "Miércoles"] } ] } ] } }

3. Ejemplo de API real (como el de Twitter)

{ "tweet": { "id": 9823451, "usuario": "@DanteDev", "likes": 120, "retweets": 30, "contenido": "Aprendiendo JSON con ChatGPT!", "hashtags": ["#JSON", "#Programación", "#Web"] } }

¿Dónde se usa JSON?

APIs REST

Se usa para enviar respuestas a clientes.

Aplicaciones móviles

Para consultar datos de servidores.

Bases de datos NoSQL

MongoDB usa documentos JSON-like.

Configuraciones

Archivos como package.json.

Videojuegos

Para registros, niveles, personajes.

Microservicios

Intercambio de datos entre servicios.

Comparación: JSON vs XML vs YAML

Formato	Ventajas	Desventajas
JSON	Ligero, rápido, fácil de usar	No permite comentarios
XML	Muy estructurado y validable	Extenso y complicado
YAML	Más legible para humanos	Puede ser confuso por indentación

Errores comunes al usar JSON

Olvidar comillas dobles en claves o strings.
Colocar comas al final de listas.
Usar comentarios (JSON no los permite).
Tipos incorrectos en valores.
No validar la estructura antes de enviarla.

Ejemplo de error común

{ nombre: "Luis" // ERROR: faltan comillas }

Buenas Prácticas al Usar JSON

Usa nombres de claves claros y cortos.
Valida el JSON antes de enviarlo.
No incluyas datos innecesarios.
Evita anidaciones excesivas.
Usa JSON Schema para validar estructuras.

Validación con JSON Schema

JSON Schema permite definir reglas de validación para asegurar que los datos enviados a una API cumplan la estructura correcta.

Ejemplo de JSON Schema

{ "type": "object", "properties": { "nombre": { "type": "string" }, "edad": { "type": "number" } }, "required": ["nombre"] }