Formateador y validador de JSON

Cómo usar el formateador JSON

Este formateador JSON hace que tu JSON sea legible o compacto y muestra exactamente dónde está cualquier error de sintaxis. Pega tu JSON en el panel de la izquierda y elige Formatear. La herramienta comprueba primero si el texto es JSON válido y después lo ordena con limpieza, con una sangría de dos o cuatro espacios o un tabulador. Minificar hace lo contrario: elimina todos los espacios y saltos de línea innecesarios y deja una versión compacta para un archivo de configuración, una petición de prueba o una variable de entorno.

Activa Ordenar claves alfabéticamente si quieres comparar dos respuestas de una API. Los objetos se ordenan entonces por nombre de clave en todos los niveles, mientras que el orden dentro de los arrays se mantiene, porque en JSON ese orden sí tiene significado. Debajo del resultado ves qué tamaño tiene el JSON, cuántas claves contiene y cuántos niveles de anidamiento tiene la estructura. Es práctico para comprobar rápidamente si una respuesta está completa o es inesperadamente grande.

Copiar pone el resultado en tu portapapeles y Descargar te da un archivo .json. Todo ocurre en tu navegador. Por eso la herramienta es adecuada para datos que quieres tratar con cuidado, como una respuesta de API con datos de clientes o una configuración con direcciones internas.

Validar JSON: localizar errores por línea y columna

Un validador de JSON no solo debe decirte que algo está mal, sino también dónde. Cuando una API o una importación rechaza un archivo, a menudo solo obtienes un mensaje vago como «Unexpected token». Esta herramienta localiza el error por sí misma y muestra el número de línea, la columna y el texto que lo rodea, con la línea resaltada en el panel de entrada. Ir al error lleva el cursor directamente al punto correcto.

La mayoría de los errores surgen porque JSON se parece a JavaScript pero es más estricto. Las claves deben ir siempre entre comillas dobles, no se permiten comillas simples y no puede haber una coma después del último elemento de un objeto o array. Los comentarios con // o /* */ tampoco existen en JSON, ni undefined, NaN o las formas de Python True y None. Cuando la herramienta reconoce uno de estos patrones, añade un consejo concreto.

Un error no siempre está exactamente donde se indica. Si falta una coma o un corchete de cierre, el analizador solo lo nota en el carácter siguiente. Mira por tanto también la línea anterior. Por eso el fragmento del mensaje de error muestra dos líneas antes del error.

¿Qué es JSON y por qué importa el formato?

JSON (JavaScript Object Notation) es el formato estándar que usan los sistemas para intercambiar datos. Casi todas las API modernas, desde tu tienda online y tu software de contabilidad hasta un CRM o un proveedor de pagos, envían y reciben JSON. El formato tiene solo unos pocos elementos: objetos con claves y valores, arrays, cadenas, números, true, false y null. Precisamente porque es tan sencillo, cualquier lenguaje de programación puede trabajar con él.

Para un ordenador, el formato no cambia nada: un JSON minificado y uno bien sangrado significan exactamente lo mismo. Para las personas, la diferencia es enorme. Una respuesta de API en una sola línea larga es ilegible, mientras que una versión formateada muestra la estructura de un vistazo: qué campos hay, qué contiene una lista y dónde falta un valor. Minificar tiene sentido cuando importa el tamaño del archivo, por ejemplo con grandes volúmenes de tráfico o un almacenamiento limitado.

Ten cuidado con los números muy grandes. JSON en sí no tiene límite, pero los navegadores y JavaScript calculan con precisión números de hasta unos 16 dígitos. Por eso, un ID o un número de cuenta con más dígitos puede volver ligeramente distinto tras el formateo. Los sistemas que intercambian este tipo de valores suelen enviarlos como cadenas precisamente por eso.

De JSON suelto a una integración fiable

Un formateador es ideal para inspeccionar una respuesta de API o comprobar una configuración. Si te encuentras a menudo copiando JSON de un sistema, editándolo y pegándolo en otro, es señal de que una integración en condiciones te ahorraría tiempo y errores. Una buena integración valida los datos automáticamente con un esquema, detecta los errores antes de que lleguen a tus registros y deja constancia de lo que ha fallado.

Al diseñar una integración así se tiene en cuenta algo más que el formato: qué campos son obligatorios, cómo tratar los valores que faltan, qué ocurre cuando un sistema no está disponible temporalmente y cómo evitar que un pedido se procese dos veces. Son exactamente los puntos en los que copiar y pegar a mano acaba fallando tarde o temprano.