Desarrollo 6 min de lectura
Si alguna vez has trabajado con una API, un archivo de configuración o una exportación de datos, ya te has topado con JSON. Parece sencillo, pero una sola coma fuera de lugar basta para invalidar todo el archivo y mostrar un mensaje de error críptico.
En esta guía aprenderás qué es JSON, qué tipos de valor admite, las reglas de sintaxis, los errores más comunes con ejemplos de antes y después, y cómo validar, formatear y minificar tus datos en segundos.
Valida y formatea tu JSON ahora Pega tu JSON para encontrar errores, formatearlo o minificarlo. Todo se ejecuta en tu navegador y no se sube nada. Abrir el formateador de JSON¿Qué es JSON?
JSON (JavaScript Object Notation) es un formato de texto ligero para almacenar e intercambiar datos. Los datos se organizan en pares de clave y valor, por ejemplo {"nombre": "Ana", "edad": 30}. Es fácil de leer para las personas y fácil de interpretar para los programas.
Aunque nació en JavaScript, JSON no depende de ningún lenguaje. Es el estándar con el que las APIs web envían datos entre servidores y aplicaciones, y también se usa mucho en archivos de configuración, registros y exportaciones.
Los seis tipos de valor
Todo valor en JSON es de uno de estos seis tipos:
- Cadena (string): texto entre comillas dobles, como "hola".
- Número: entero o decimal, como 42 o 3.14, sin comillas.
- Booleano: true o false, en minúsculas y sin comillas.
- Nulo: la palabra null, que significa "sin valor".
- Array: lista ordenada entre corchetes, como [1, 2, 3].
- Objeto: conjunto de pares clave y valor entre llaves, como {"ciudad": "Sevilla"}. Las claves son siempre cadenas.
Los arrays y los objetos pueden contener otros arrays y objetos, así que puedes describir datos con cualquier profundidad.
Las reglas de sintaxis que debes recordar
JSON es mucho más estricto que JavaScript. La mayoría de los errores nacen de romper una de estas reglas:
- Las cadenas y las claves deben usar comillas dobles. No se permiten comillas simples.
- Sin comas finales: el último elemento de un array u objeto no puede ir seguido de una coma.
- Sin comentarios: ni // ni /* */ son válidos.
- Solo existen los seis tipos: undefined, NaN, Infinity y las funciones no son válidos.
- Los pares se separan con comas, y la clave se separa del valor con dos puntos.
- Cada llave o corchete que se abre necesita su cierre.
Los errores más comunes y cómo corregirlos
Estos cinco descuidos causan la gran mayoría de los mensajes de "JSON no válido":
- Coma final. Antes: {"a": 1, "b": 2,}. Después: {"a": 1, "b": 2}. Quita la coma tras el último elemento.
- Comillas simples. Antes: {'nombre': 'Ana'}. Después: {"nombre": "Ana"}. Cambia todas las comillas simples por comillas dobles.
- Clave sin comillas. Antes: {nombre: "Ana"}. Después: {"nombre": "Ana"}. Pon todas las claves entre comillas dobles.
- Falta un corchete o una llave. Antes: {"items": [1, 2, 3}. Después: {"items": [1, 2, 3]}. Cierra cada array y objeto que abras.
- Escape incorrecto de comillas. Antes: {"texto": "Dijo "hola""}. Después: {"texto": "Dijo \"hola\""}. Las comillas dobles dentro de una cadena deben llevar una barra invertida. Lo mismo vale para la propia barra invertida, que se escribe \\.
Cuidado también con las comillas "tipográficas" pegadas desde procesadores de texto: parecen comillas, pero no son válidas en JSON.
Cómo leer el mensaje de error de JSON
La mayoría de los analizadores indican dónde se perdieron, con mensajes como "Unexpected token } in JSON at position 25" o "Expected double-quoted property name at line 3 column 5". La posición es el número de caracteres desde el inicio, mientras que la línea y la columna señalan el punto exacto.
El fallo real suele estar justo antes de la posición indicada. Una llave de cierre inesperada normalmente significa que hay una coma final justo antes, y un final de datos inesperado suele indicar un corchete sin cerrar. Mira la línea indicada y la anterior.
Cómo validar, formatear y minificar JSON
- Abre el formateador de JSON gratuito. Se ejecuta por completo en tu navegador, así que tus datos no salen de tu dispositivo.
- Pega tu JSON. Si no es válido, la herramienta muestra el error con su línea y columna para que lo corrijas.
- Usa el formateo para indentar y hacerlo legible, o minifica para quitar espacios y reducir el tamaño antes de enviarlo.
- Copia el resultado. Si cambiaste un archivo y quieres ver exactamente qué es distinto, compara ambas versiones con la herramienta de diferencias de texto.
JSON vs XML vs YAML
XML es más extenso, con etiquetas de apertura y cierre, pero admite atributos y sigue siendo común en sistemas antiguos. YAML es más limpio para las personas y permite comentarios, por eso es popular en archivos de configuración, aunque su indentación es fácil de equivocar.
JSON queda en el punto medio: compacto, sin ambigüedades y compatible con prácticamente todos los lenguajes, lo que lo convierte en la opción habitual para las APIs. Su principal desventaja es la falta de comentarios.
Consejos prácticos
- Valida siempre el JSON antes de enviarlo o guardarlo en un archivo de configuración.
- Usa un editor con resaltado de sintaxis para JSON, que muestra al instante comillas y corchetes desparejados.
- No escribas JSON a mano cuando puedas generarlo con código: las bibliotecas escapan bien los caracteres.
- Si un parámetro de URL lleva JSON, codifícalo antes con el codificador de URL para que los caracteres especiales no rompan la petición.
- Nunca pegues contraseñas ni tokens en herramientas online que suben los datos. Prefiere herramientas que funcionen en local.
Conclusión
JSON es sencillo cuando conoces sus reglas: seis tipos de valor, comillas dobles, sin comas finales y sin comentarios. Cuando algo falle, lee la línea y la columna del error, revisa el punto justo anterior y deja que un validador haga el trabajo pesado. Unos segundos con un formateador ahorran mucho tiempo de depuración.
Preguntas frecuentes
¿Para qué sirve JSON?
Sirve para intercambiar datos entre aplicaciones, sobre todo APIs web, y para guardar configuraciones y datos estructurados en archivos. Casi todos los lenguajes de programación pueden leerlo y escribirlo.
¿JSON puede tener comentarios?
No. El JSON estándar no admite comentarios. Si necesitas notas, añade un campo normal como "comentario" o usa un formato como YAML para archivos de configuración.
¿Por qué mi JSON dice "unexpected token"?
El analizador encontró un carácter inesperado, normalmente una coma final, comillas simples, una clave sin comillas o un corchete que falta. Revisa la posición indicada y la línea justo encima.
¿Cuál es la diferencia entre formatear y minificar JSON?
Formatear añade saltos de línea e indentación para que sea legible. Minificar elimina todos los espacios innecesarios para reducir el tamaño. Los datos son exactamente los mismos.
¿Es seguro usar un formateador de JSON online?
Es seguro cuando la herramienta funciona en tu navegador y no envía el contenido a un servidor. Nuestro formateador de JSON procesa todo localmente en tu dispositivo.
Herramientas gratuitas mencionadas en este artículo
Sigue leyendo
- Cómo Crear una Contraseña SeguraLongitud, aleatoriedad y unicidad: las reglas simples que de verdad protegen tus cuentas y cómo seguirlas sin tener que memorizar nada.
- Técnica Pomodoro: guía completaTrabaja en bloques de 25 minutos de concentración con descansos cortos. Descubre cómo funciona el método, cómo empezar hoy y cómo adaptarlo a tu rutina.
- ¿Qué es un hash? MD5, SHA-256 y para qué sirvenUn hash es una huella digital corta de cualquier dato. Aprende cómo funciona, qué algoritmos usar y cómo verificar archivos y proteger contraseñas.