Validador de JSON
Comprueba si un texto sigue la sintaxis JSON estándar y entiende por qué una entrada es aceptada o rechazada.
Comprueba JSON antes de usar los datos
Una comilla, una coma o un corchete que falten pueden detener una API, una configuración o una compilación. El validador ofrece un lugar concreto para comprobar el texto con la gramática JSON y separar un error de sintaxis de las reglas posteriores de la aplicación.
Aquí validar significa analizar el texto proporcionado como JSON. Si el análisis termina, la estructura fue aceptada por el validador. Eso no demuestra que existan campos obligatorios, que los valores cumplan reglas de negocio o que el documento coincida con un JSON Schema.
La sintaxis y el significado son distintos
El JSON estándar contiene objetos, matrices, cadenas, números, true, false y null. Los nombres y las cadenas usan comillas dobles, los miembros se separan con comas y los corchetes deben cerrarse en el orden correcto. Los comentarios y las comas finales no pertenecen a la gramática estándar.
El validador responde a una pregunta limitada: ¿se puede analizar esta fuente como un valor JSON? No repara la fuente, ejecuta código, contacta una API ni decide si un valor sirve para tu aplicación. Mantén las comprobaciones de esquema y dominio como pasos separados.
Cómo validar JSON
- Pega un valor JSON completo en el campo de fuente.
- Ejecuta el validador y lee el estado o el diagnóstico.
- Si se rechaza, revisa comillas, comas, corchetes, escapes y el valor cercano al área indicada.
- Cuando la sintaxis sea válida, ejecuta las comprobaciones de esquema y de aplicación que requiera tu proyecto.
Método de validación
- Leer la gramática
El validador intenta analizar toda la fuente como un valor JSON. La entrada debe usar los tokens y las reglas de anidación aceptadas.
- Indicar aceptación o fallo
Un resultado correcto indica que el análisis terminó. Un fallo indica que la fuente no cumple la sintaxis que entiende el validador.
- Separar las comprobaciones posteriores
Las restricciones de esquema, propiedades obligatorias, rangos y permisos son comprobaciones semánticas. Necesitan evidencia propia.
No inventes un número de línea ni un mensaje exacto si la herramienta no lo devuelve para esa entrada.
Leer el resultado
Un resultado válido significa que el texto fue aceptado como sintaxis JSON. Después puedes revisar los valores o pasarlos a una comprobación de esquema y de aplicación.
Un resultado inválido significa que el análisis se detuvo. Lee el diagnóstico en contexto y revisa los caracteres antes y después del área indicada.
Errores habituales
Es frecuente pegar sintaxis de JavaScript con comillas simples, comentarios o comas finales. Convierte la entrada a JSON estándar en lugar de asumir que las formas parecidas son intercambiables.
A veces se confunde un resultado válido con la validación de un esquema. Comprueba campos obligatorios, rangos y permisos en el sistema que posee esas reglas.
Limitaciones
La entrada documentada es un campo de texto JSON. Eso no demuestra validación de JSON Schema, reglas de negocio, archivos ni un comportamiento idéntico en todos los analizadores.
Las claves duplicadas, los números muy grandes y la codificación posterior requieren pruebas independientes cuando afectan al consumidor.
Examples
Aceptar un objeto sencillo
¿Es válido este objeto básico?
Envía el objeto completo.
La fuente usa nombres entre comillas, una cadena y un booleano en una estructura válida.
Rechazar un nombre sin comillas
¿Por qué no es válido el nombre sin comillas?
Envía la fuente y revisa el fallo.
El JSON estándar exige que el nombre del miembro sea una cadena entre comillas dobles.
Aceptar datos anidados
¿Puede un objeto contener una matriz de objetos?
Envía el valor anidado como un documento.
La matriz, los objetos, los números, las comas y los corchetes forman sintaxis JSON válida.
Rechazar una coma final
¿Qué ocurre con una coma después del último miembro?
Envía el objeto con la coma final.
La coma final no está permitida en JSON estándar. Elimínala y vuelve a validar.
Conservar null
¿Es null un valor JSON válido?
Envía el objeto y lee el estado.
null es un valor JSON estándar. Su significado en una aplicación se decide aparte.
Rechazar un corchete sin cerrar
¿Por qué debe cerrarse cada corchete?
Envía la estructura desequilibrada.
La matriz se abre con [ pero no se cierra con ]. Corrige el anidamiento antes de usar los datos.
Frequently asked questions
¿JSON válido significa datos válidos para la aplicación?
No. Significa que el texto se puede analizar como JSON. Los campos, tipos, rangos y reglas de negocio necesitan comprobaciones separadas.
¿Puede el validador reparar la fuente?
Úsalo como comprobador. Corrige tú la fuente y envíala de nuevo para verificar el texto modificado.
¿Se permiten comentarios?
No en JSON estándar. Elimínalos o usa un paso documentado que produzca JSON estándar.
¿Por qué se rechazan las comillas simples?
La sintaxis estándar usa comillas dobles para nombres y cadenas. Las simples pertenecen a algunas sintaxis de programación.
¿Comprueba JSON Schema?
El contrato de entrada documenta texto JSON, no un campo de esquema. No describas validación de Schema sin evidencia independiente.
¿Puede una matriz ser el valor principal?
JSON puede representar una matriz como valor. Envía una matriz completa y lee el resultado según la gramática que documente el validador.
¿Siempre se rechazan las claves duplicadas?
No supongas una política universal. La aceptación y el valor resultante pueden depender del analizador, así que prueba el consumidor si importa.
¿Qué hago después de validar?
Ejecuta las comprobaciones del proyecto, como JSON Schema, permisos, rangos de valores y pruebas de integración.