Validador y embellecedor de JSON

Qué hace esta herramienta

Pegas JSON, presionas el botón y obtienes una de dos cosas: el documento reformateado con la indentación que elijas, o el error exacto de sintaxis que impide interpretarlo. Todo ocurre en tu navegador —no hay subida de archivos ni llamadas a un servidor— así que puedes pegar la respuesta de una API con tokens o datos de clientes sin que salga de tu equipo.

Es la operación que se hace decenas de veces al día cuando trabajas con APIs: llega una respuesta minificada en una sola línea de 4.000 caracteres y necesitas leerla antes de decidir qué hacer con ella.

Cómo usarla

1. Pega el JSON en el campo de entrada. Sirve tanto minificado como ya formateado.
2. Elige la indentación: 2 espacios, 4 espacios o tabulador.
3. Presiona Validar y Embellecer JSON.
4. Copia el resultado con un clic.

Si el documento es válido, el panel de salida muestra la versión indentada. Si no lo es, muestra el mensaje del parser con la posición del carácter que rompe el análisis.

Los errores de JSON que aparecen una y otra vez

JSON es un formato deliberadamente pequeño. La mayoría de errores vienen de asumir que acepta cosas que sí acepta JavaScript.

Coma sobrante

{
  "nombre": "Marco",
  "rol": "desarrollador",
}

Esa coma después del último valor es válida en un objeto literal de JavaScript y en Python, pero no en JSON. Es, con diferencia, el error más frecuente.

Comillas simples

{ 'nombre': 'Marco' }

La especificación exige comillas dobles, tanto en claves como en valores de tipo cadena. Las comillas simples no son JSON.

Claves sin comillas

{ nombre: "Marco" }

En JavaScript la clave puede ir desnuda. En JSON siempre va entrecomillada.

Comentarios

{
  // el identificador del usuario
  "id": 42
}

JSON no tiene comentarios. Ni // ni /* */. Si necesitas anotar un archivo de configuración, o usas un formato que sí los admite —YAML, JSON5, TOML— o metes la nota en una clave más.

NaN, Infinity y undefined

No existen en JSON. Los números deben ser finitos, y la ausencia de valor se representa con null. Si serializas desde JavaScript, JSON.stringify convierte undefined en nada dentro de un objeto y en null dentro de un array — una asimetría que provoca sorpresas.

Copiar desde la consola del navegador

Cuando expandes un objeto en las DevTools y le das a Copy object, lo que se copia suele ser notación JavaScript, con claves sin comillas y a veces referencias circulares recortadas. Para obtener JSON real usa copy(JSON.stringify(obj)) en la consola.

Embellecer o minificar: cuándo cada uno

Son la misma operación en direcciones opuestas, y la elección depende de quién va a leer el resultado.

Embellecer cuando el JSON lo va a leer una persona: depurando una respuesta de API, revisando un package.json, comparando dos payloads en un diff. La indentación es lo que hace visible la estructura de anidamiento.

Minificar cuando el JSON lo va a leer una máquina: cuerpos de peticiones HTTP, valores dentro de una base de datos, ficheros que se sirven al cliente. Quitar espacios en blanco reduce el peso sin cambiar el contenido, y en respuestas grandes el ahorro es real.

Un detalle que ahorra discusiones en revisiones de código: los archivos JSON versionados en Git conviene guardarlos formateados y con claves en orden estable. Un diff sobre una sola línea de 4.000 caracteres es ilegible; sobre un documento indentado, se ve exactamente qué cambió.

JSON en tres reglas

Si tuvieras que recordar solo tres cosas del formato:

• Los tipos son seis: cadena, número, booleano, null, array y objeto. No hay fechas, ni enteros frente a decimales, ni comentarios. Las fechas viajan como cadenas, casi siempre en ISO 8601.
• Las claves son cadenas y van entre comillas dobles, siempre.
• El nivel superior puede ser cualquier valor. Un array en la raíz es JSON válido, y también lo es 42 o "hola" a secas. La idea de que un documento JSON tiene que ser un objeto es un mito heredado de versiones antiguas de la especificación.

Preguntas relacionadas con el formato

Si lo que necesitas no es validar sino transformar, hay herramientas específicas para cada caso: convertir el documento a otro formato de datos, generar los tipos de tu lenguaje a partir de una muestra, o comparar dos versiones para ver qué cambió entre ellas.