Cómo validar JSON y detectar los errores más frecuentes

Qué comprueba realmente un validador JSON

JSON es un formato de texto para intercambiar datos con una estructura definida: objetos entre llaves, listas entre corchetes, pares de clave y valor, cadenas, números, valores booleanos y null. Validarlo consiste en comprobar que ese texto respeta la sintaxis que puede interpretar un lector JSON. Es un paso útil antes de pegar una configuración, preparar una petición de prueba o entregar un archivo a otra persona.

El Validador JSON de Nítido Tools intenta interpretar la entrada con JSON.parse. Si puede hacerlo, muestra «JSON válido: la estructura es correcta». Si no puede, pide revisar los datos introducidos. No modifica el texto ni lo convierte en otra cosa: responde a una pregunta concreta, si la sintaxis se puede analizar como JSON. Para ordenar e indentar un JSON que ya es válido, usa el Formateador JSON, que es una herramienta distinta.

Sintaxis válida no es lo mismo que datos correctos

Un resultado válido no confirma que los datos sirvan para tu caso. La herramienta comprueba sintaxis, no un contrato de API ni un esquema. Por ejemplo, {"cantidad":"dos"} es JSON válido aunque tu aplicación necesite que cantidad sea un número; también puede faltar una clave obligatoria, sobrar otra o tener un formato de fecha incorrecto sin que el validador lo detecte.

Conviene separar dos preguntas: «¿se puede leer este texto como JSON?» y «¿cumple las reglas de mi sistema?». La primera la resuelve el Validador JSON; la segunda requiere comparar el contenido con la documentación del servicio, sus ejemplos o un esquema definido para el proyecto. No des por correcta una integración solo por obtener el mensaje de validación.

Además, JSON.parse acepta valores JSON primitivos. Una entrada como 42, true, null o "listo" puede pasar la comprobación aunque el receptor espere un objeto con llaves o una lista. La especificación de JSON permite esos valores como texto JSON; la exigencia de que el valor principal sea un objeto depende del sistema con el que trabajes.

Ejemplo reproducible para empezar

Prueba primero con un caso pequeño y sin datos personales. Copia en el Validador JSON este ejemplo: {"pedido":"DEMO-104","activo":true,"articulos":[{"sku":"CUADERNO-A5","cantidad":2}]}. Al pulsar Procesar debe aparecer el mensaje de JSON válido. Hay claves entre comillas dobles, dos puntos entre cada clave y valor, y comas solo para separar elementos.

Ahora provoca un fallo controlado: cambia true por True o añade una coma justo antes de la llave final. Vuelve a procesar el texto. JSON distingue las palabras reservadas en minúscula y no admite una coma final en un objeto o una lista. Esta comparación te ayuda a reconocer qué ha cambiado cuando un bloque más grande deja de ser válido.

Cuando el ejemplo pase, sustitúyelo por tu contenido real y conserva una copia antes de editar. Si estás preparando una petición, prueba después la salida en un entorno de desarrollo con valores de demostración. Que el JSON sea legible no garantiza que una ruta, una autorización o las reglas del servidor estén bien configuradas.

Errores de JSON más frecuentes

El fallo más habitual es usar comillas simples, heredadas de JavaScript, Python u otros lenguajes. En JSON las claves y los textos deben usar comillas dobles: {"estado":"ok"} es correcto y {'estado':'ok'} no lo es. Las claves sin comillas, como {estado:"ok"}, tampoco forman JSON válido aunque se parezcan a un objeto de JavaScript.

Revisa también las comas. Entre dos propiedades o elementos debe haber una; después del último no. Un objeto como {"a":1,} y una lista como ["a","b",] fallan por esa coma sobrante. El error inverso, olvidar la coma entre dos pares, también rompe el documento. Si editas varias líneas, lee cada nivel de llaves y corchetes de fuera hacia dentro para comprobar que todos se cierran.

Otros tropiezos comunes son escribir True, False o None en lugar de true, false o null; usar un comentario con // o /* */; y poner un salto de línea o una comilla sin escapar dentro de una cadena. Los números JSON usan punto decimal y no admiten ceros iniciales innecesarios: 12.5 es válido, mientras que 12,5 y 012 no lo son.

Límites reales del Validador JSON

La herramienta muestra un mensaje general cuando la entrada no se puede analizar; no señala la línea ni la columna exacta del fallo. En un bloque largo, reduce el problema: valida una parte pequeña, recupera el último cambio o pasa el texto válido por el Formateador JSON para ver mejor la indentación. No añadas o elimines caracteres al azar, porque puedes ocultar el error original.

Tampoco valida esquemas. No puede exigir que un campo exista, que email tenga una forma concreta, que una lista no esté vacía o que una fecha sea aceptable para una API. Si esas condiciones importan, busca el esquema o la documentación del receptor y crea pruebas que cubran las propiedades obligatorias, los tipos y los valores límite.

Las claves duplicadas merecen atención especial. Por ejemplo, {"modo":"prueba","modo":"produccion"} puede superar esta comprobación sintáctica, pero no es una forma fiable de intercambiar datos: los receptores pueden tratar nombres repetidos de forma distinta. El Validador JSON no avisa de duplicados ni reescribe tu contenido. Mantén una sola clave para cada dato y comprueba qué objeto recibe realmente tu aplicación.

Privacidad local y una prueba antes de usar la salida

El texto que escribes en el Validador JSON de Nítido Tools se procesa en el navegador para obtener el resultado; el flujo de la herramienta no necesita una cuenta ni envía el bloque a un servidor de Nítido Tools para validarlo. Aun así, evita pegar secretos reales, tokens, contraseñas o datos personales cuando puedas usar valores de ejemplo. La privacidad también depende de dónde copies el contenido después y de los permisos de tu dispositivo.

Antes de usar una salida en una integración, haz una prueba breve con tres casos: un objeto mínimo que debería pasar, un caso con una coma final que debe fallar y un JSON sintácticamente válido con un tipo incorrecto para tu API. Así confirmas a la vez el comportamiento del validador y las reglas del receptor. Revisa finalmente la petición o el archivo resultante con datos no sensibles antes de pasar a producción.

Preguntas frecuentes

¿Por qué mi JSON falla si se parece a un objeto de JavaScript?

Porque JSON es más estricto: las claves y cadenas llevan comillas dobles, no admite comentarios ni comas finales y solo reconoce true, false y null en minúscula. Corrige esas diferencias y vuelve a procesar el bloque.

¿Un JSON válido siempre es aceptado por una API?

No. La API puede exigir una estructura concreta, campos obligatorios, tipos determinados, una autenticación o cabeceras específicas. El validador confirma la sintaxis; contrasta después el contenido con la documentación de la API.

¿Puedo validar solo un número o una palabra entre comillas?

Sí. JSON.parse acepta valores primitivos como 42, true, null o una cadena entre comillas, y la herramienta los considera JSON válido. Comprueba si el sistema destinatario permite ese valor principal o exige un objeto o una lista.

¿Se sube mi JSON al usar la herramienta?

La comprobación se realiza localmente en el navegador y no requiere enviar el texto a un servidor de Nítido Tools. Por prudencia, usa ejemplos sin secretos y revisa dónde compartes después el contenido.