¿Qué es JSON? Guía sencilla con ejemplos

JSON (JavaScript Object Notation) es un formato de texto sencillo para escribir datos estructurados (cosas como un cliente, un pedido o una lista de productos) como nombres emparejados con valores. Es fácil de leer para las personas y fácil de generar y analizar para los programas. Cuando las apps y los servicios intercambian datos por la web, JSON es con diferencia el formato más común.

Por qué importa JSON al construir con IA

Vas a encontrar JSON constantemente, aunque nunca escribas código:

• APIs. Cuando las pantallas de tu app cargan datos de su backend, o tu backend llama a un servicio de pagos, correo o IA, los datos normalmente viajan en JSON. Consulta qué es una API.
• Archivos de configuración. Muchos archivos de configuración de proyectos son JSON, por ejemplo package.json, que enumera las dependencias de un proyecto de JavaScript.
• Bases de datos. Postgres puede guardar JSON en una columna (el tipo jsonb) para datos que no encajan en filas y columnas ordenadas. Consulta qué es Postgres.
• Salida de la IA. Cuando quieres que un modelo de IA devuelva algo que un programa pueda usar, como una lista de etiquetas o campos extraídos de una factura, normalmente pides JSON.
• Mensajes de error y registros. Muchos errores llegan en JSON, y leerlos suele ser la forma más rápida de saber qué salió mal.

Saber leer JSON te permite comprobar lo que realmente recibió tu app, detectar un campo que falta y describir los problemas con precisión a tu creador de apps con IA.

Una analogía cotidiana

Piensa en un formulario de papel: Nombre: ____, Teléfono: ____, Boletín: ☐ sí ☐ no. Cada respuesta es una etiqueta con un valor al lado. JSON es ese formulario escrito como texto, con un diseño estricto que una computadora puede leer sin adivinar. Y como los formularios, JSON puede tener secciones dentro de secciones (un bloque de dirección con calle, ciudad y código postal) y listas (varios números de teléfono).

Cómo se ve JSON

Aquí está una reserva en JSON:

{
  "id": 5001,
  "customer": "Lena Park",
  "service": "Corte de pelo",
  "startsAt": "2026-10-03T14:00:00Z",
  "price": 35.5,
  "paid": false,
  "notes": null,
  "extras": ["arreglo de barba", "toalla caliente"],
  "contact": {
    "email": "lena@example.com",
    "phone": "+44 20 7946 0000"
  }
}

Cómo leerlo:

• Las llaves { } envuelven un objeto: un conjunto de pares nombre/valor.
• Cada par es "nombre": valor, separados por comas.
• Los corchetes [ ] envuelven un array: una lista ordenada.
• Los objetos y los arrays pueden estar dentro de otros, como ocurre con contact y extras.

Los seis tipos de valor

JSON solo tiene seis tipos de valor. Esa lista tan corta es en buena parte la razón por la que funciona en todas partes.

No hay tipo de fecha. Las fechas se escriben como cadenas, normalmente en el formato ISO 8601 mostrado arriba (2026-10-03T14:00:00Z, donde Z significa UTC). Acordar ese formato evita toda una categoría de errores de zona horaria.

Las reglas estrictas (de donde vienen los errores)

JSON es menos indulgente de lo que parece. Todos estos son inválidos:

{ name: "Lena" }            ← clave sin comillas dobles
{ 'name': 'Lena' }          ← comillas simples
{ "a": 1, "b": 2, }         ← coma final
{ "a": 1 "b": 2 }           ← falta una coma
{ "a": 1 // comentario }    ← los comentarios no están permitidos

La mayoría de los errores «Unexpected token» son uno de estos. Un validador o formateador de JSON te mostrará la línea exacta.

Ejemplo práctico: JSON a través de una app

Un cliente reserva un corte de pelo en una app de salón. Así aparece el JSON:

1. El formulario de reserva envía esto al backend de la app:

{ "service": "Corte de pelo", "startsAt": "2026-10-03T14:00:00Z", "name": "Lena Park" }

1. El backend guarda la reserva en la base de datos y responde con el estado 201 Created y:

{ "id": 5001, "status": "confirmed" }

1. Si la hora ya estaba ocupada, podría responder con el estado 409 Conflict y:

{ "error": "slot_taken", "message": "Esa hora acaba de reservarse. Por favor, elige otra." }

La página lee status o error y muestra el mensaje correcto. Si la página mostrara una pantalla en blanco, abrir las herramientas para desarrolladores del navegador (pestaña Network) te mostraría este JSON, que a menudo es la pista más rápida de lo que salió mal.

Términos clave

Malentendidos comunes

• «JSON es JavaScript». Tomó su sintaxis de JavaScript, pero es independiente del lenguaje; Python, Java, C#, Go y el resto lo leen.
• «Los números entre comillas están bien». "35" es una cadena, no un número. Mezclarlos causa errores como que "35" + "5" dé "355". El dinero suele guardarse en céntimos enteros (3550) para evitar problemas de redondeo.
• «JSON es seguro porque son solo datos». JSON puede llevar cualquier cosa, incluidos secretos. No pongas claves de API en un JSON que se envíe al navegador.
• «Guarda todo en una columna JSON». Es práctico para extras flexibles, pero los datos por los que buscas, filtras o cruzas normalmente deben ir en columnas propias.
• «La IA siempre devuelve JSON válido». Los modelos pueden añadir texto extra o romper el formato. Muchos proveedores ofrecen un modo de salida estructurada; tu código aun así debe comprobar lo que recibe.

Qué pedir a tu creador de apps con IA

• «Muéstrame un ejemplo del JSON que devuelve este endpoint.»
• «Devuelve los errores como JSON con un código error y un message legible para personas.»
• «Guarda las fechas como cadenas ISO 8601 en UTC y convierte a la hora local solo al mostrarlas en pantalla.»
• «Guarda los precios como céntimos enteros.»
• «Valida el JSON entrante en el servidor y rechaza las solicitudes con campos faltantes o de tipo incorrecto.»
• «Al llamar al modelo de IA, pide JSON con esta forma exacta y compruébalo antes de usarlo.»

JSON en Mythex

No necesitas escribir JSON a mano en Mythex: describes lo que quieres y el agente escribe el código que lo envía y lo lee. Aun así, conviene reconocerlo: cuando algo falla, pegar el error de JSON en el chat le da al agente una pista precisa. La receta de backend REST API de la documentación pide «errores JSON claros» desde el principio, y la receta integrar cualquier API explica cómo llamar a servicios externos. Para ver el panorama general, consulta REST vs GraphQL y cómo depurar una app creada con IA.

Preguntas