Qué es JSON y Para Qué Sirve: Guía para Principiantes (con Ejemplos)

Si empezaste a programar o a trabajar con APIs seguro te cruzaste con la palabra JSON más de una vez. En esta guía te explicamos qué es, cómo se escribe y para qué se usa, con ejemplos simples pensados para quien lo ve por primera vez.

¿Qué es JSON?

JSON (JavaScript Object Notation) es un formato de texto para representar datos estructurados de forma simple y legible tanto para personas como para computadoras. A pesar del nombre, no es exclusivo de JavaScript: hoy se usa en prácticamente todos los lenguajes de programación (Python, Java, PHP, C#, etc.) porque se convirtió en el estándar de facto para intercambiar información entre sistemas, especialmente en APIs web.

Estructura básica de un JSON

Un JSON se arma con pares de clave-valor, similar a un diccionario. Un ejemplo simple:

{
  "nombre": "Ana",
  "edad": 28,
  "activo": true,
  "ciudad": "Asunción",
  "hobbies": ["lectura", "ciclismo"]
}

Los tipos de datos que admite JSON son: texto (entre comillas dobles), números, booleanos (true/false), null, objetos (entre llaves { }) y arrays o listas (entre corchetes [ ]). Se pueden anidar objetos dentro de objetos y arrays dentro de arrays para representar estructuras más complejas.

¿Para qué se usa JSON en la práctica?

• APIs web: cuando una app pide datos a un servidor (por ejemplo, el clima o el precio de un producto), la respuesta casi siempre viene en formato JSON.
• Archivos de configuración: muchas herramientas (como package.json en proyectos de Node.js) usan JSON para guardar configuración.
• Guardar datos estructurados: bases de datos NoSQL como MongoDB almacenan documentos con una estructura muy similar a JSON.
• Intercambio entre sistemas: dos aplicaciones distintas, escritas en lenguajes distintos, pueden "hablar" entre sí usando JSON como formato común.

Errores comunes al escribir JSON a mano

JSON es estricto con su sintaxis: un solo error rompe todo el archivo. Los más comunes:

• Comillas simples en vez de dobles: JSON exige comillas dobles ("texto"), no simples ('texto').
• Coma sobrante al final: {"a": 1, "b": 2,} es inválido por la coma final después del último valor.
• Claves sin comillas: a diferencia de un objeto JavaScript, en JSON las claves siempre van entre comillas dobles.
• Comentarios: JSON no admite comentarios (ni con // ni con /* */), a diferencia de otros formatos como JSON5 o YAML.

Para detectar estos errores rápido, lo más práctico es pegar el JSON en un validador y formateador de JSON online: te marca exactamente dónde está el error de sintaxis y además ordena el código con la indentación correcta para que sea más fácil de leer.

JSON vs. otros formatos: XML y YAML

Antes de JSON, el formato más usado para intercambiar datos era XML, mucho más verboso (necesita etiquetas de apertura y cierre para cada dato). JSON se impuso por ser más liviano y más fácil de leer. YAML, por su parte, es aún más legible para humanos (sin llaves ni comillas) y se usa mucho en archivos de configuración, pero JSON sigue siendo el estándar en el intercambio de datos vía web por su simplicidad y soporte nativo en JavaScript.

Preguntas frecuentes

Última actualización: 22 de agosto de 2026