Qué es JSON y cómo formatearlo y validarlo correctamente

JSON es el formato en el que hablan las APIs, las configuraciones y media web moderna. Es simple, pero pequeños descuidos de sintaxis provocan errores difíciles de ver a simple vista en un bloque comprimido de una sola línea. Esta guía explica cómo está hecho JSON, cómo formatearlo para leerlo y cómo validarlo para encontrar el fallo.

Qué es JSON

JSON (JavaScript Object Notation) es un formato de texto para representar datos estructurados. Nació de JavaScript pero hoy lo usan todos los lenguajes. Su éxito viene de ser legible para humanos y fácil de parsear para máquinas.

Tipos de datos que admite:

String: texto entre comillas dobles → "hola"
Number: entero o decimal → 42, 3.14
Boolean: true o false
Null: null
Array: lista ordenada → [1, 2, 3]
Object: pares clave-valor → { "clave": "valor" }

Las reglas que más se incumplen

JSON es estricto. Estos son los errores que más rompen un parseo:

Comillas simples: las claves y strings van con comillas dobles, nunca simples. 'mal' → "bien".
Coma final (trailing comma): [1, 2, 3,] es inválido. La última coma sobra.
Claves sin comillas: { clave: 1 } es JavaScript, no JSON. Debe ser { "clave": 1 }.
Comentarios: JSON no admite comentarios (// o /* */). Si los necesitas, es otro formato (JSON5, JSONC).
Números mal formados: nada de +1, 01 ni .5 (usa 0.5).

Formatear JSON (pretty print)

Una respuesta de API suele venir minificada: todo en una línea, sin espacios. Eso ahorra bytes pero es ilegible. Formatear (o pretty print) añade saltos de línea e indentación para que puedas leer la estructura:

Minificado:

{"usuario":{"nombre":"Ana","roles":["admin","editor"],"activo":true}}

Formateado:

{
  "usuario": {
    "nombre": "Ana",
    "roles": ["admin", "editor"],
    "activo": true
  }
}

Mucho más fácil de inspeccionar. Puedes formatear y validar gratis con el formateador de JSON, que procesa todo en tu navegador.

Validar JSON: encontrar el error

Validar significa comprobar que el JSON cumple la sintaxis. Un buen validador no solo dice "inválido": te indica en qué línea y posición está el problema, que suele ser una coma de más, una comilla mal cerrada o una llave sin pareja.

El flujo típico de depuración:

Pega el JSON en el validador.
Si hay error, mira la línea que señala.
Busca el problema clásico cerca de ahí: coma final, comilla simple, llave/corchete sin cerrar.
Corrige y vuelve a validar.

Minificar JSON

El camino inverso al formateo: quitar todos los espacios e indentación para reducir el tamaño. Útil cuando vas a enviar el JSON por red o guardarlo en una configuración donde el peso importa. Un solo carácter de diferencia en miles de líneas suma.

Por qué procesarlo en el navegador

Los JSON que depuras suelen contener datos reales: respuestas con información de usuarios, tokens, configuraciones internas. Una herramienta que formatea y valida en tu navegador garantiza que esos datos no se suben a ningún servidor. Es más rápido y más privado.

Preguntas frecuentes

¿Cuál es la diferencia entre formatear y validar? Formatear cambia la presentación (indentación); validar comprueba que la sintaxis es correcta. Un buen formateador hace ambas.

¿JSON admite comentarios? No. Para comentarios usa JSON5 o JSONC, que son extensiones no estándar.

¿Por qué falla mi JSON si "se ve bien"? Casi siempre es una coma final, una comilla simple o una llave sin cerrar. Usa un validador que señale la línea.

¿Se suben mis datos? No, si usas un formateador local. Todo ocurre en el navegador.

Formatea, valida y minifica tus datos al instante con el formateador de JSON gratis, 100% en tu navegador y sin subir nada.