Cómo validar JSON contra un JSON Schema
- Pega el documento JSON que quieres comprobar en la primera caja (etiquetada “Texto original”).
- Pega el JSON Schema contra el que validarlo en la segunda caja (etiquetada “Texto modificado”).
- Elige el draft de JSON Schema para el que se escribió tu esquema, draft-07 (el valor por defecto, y el más común en la práctica) o 2020-12 (el draft actual y más reciente).
- Haz clic en el botón. El resultado muestra si el documento es válido y, si no, una lista numerada de cada error con su ubicación exacta.
Para generar un esquema inicial en lugar de validar uno, cambia el Modo a “Generar un esquema a partir de un ejemplo”, pega un documento JSON de ejemplo real en la primera caja, y haz clic en el botón, vuelve un JSON Schema listo para copiar.
Por qué importan las “rutas de error claras”
La mayoría de los validadores rápidos de JSON Schema online simplemente dicen “inválido” y se detienen ahí, dejándote comparar manualmente un documento grande contra un esquema grande línea por línea. Esta herramienta usa Ajv, el mismo motor real de validación de JSON Schema usado por innumerables aplicaciones de producción en Node.js y navegador, y convierte su salida de error en bruto en una lista en lenguaje llano, cada una mostrando el punto exacto en el documento (como una ruta /items/2/price) y qué está mal en él. Depurar una prueba de contrato de API fallida, un archivo de configuración roto, o un payload de webhook malformado normalmente se reduce a encontrar el ÚNICO campo que está mal, esta herramienta apunta directamente a él en lugar de hacerte adivinar.
Dos drafts, porque los esquemas reales usan ambos
JSON Schema ha evolucionado a través de varios drafts, y los dos que realmente importan hoy son draft-07 (todavía el más común, la versión a la que apuntan la mayoría de esquemas existentes, tutoriales y especificaciones OpenAPI 3.0) y 2020-12 (el draft actual, usado por OpenAPI 3.1 y herramientas de generación de esquemas más nuevas). Elegir el draft equivocado puede cambiar silenciosamente el comportamiento de validación para ciertas características del esquema, así que esta herramienta te deja elegir explícitamente en lugar de adivinar, y valida contra el conjunto de reglas real y correcto para el que elijas.
Tus datos nunca salen de tu navegador
Los cuerpos de petición de API, los payloads de webhook y los archivos de configuración a menudo contienen datos reales de clientes, identificadores internos o credenciales, no algo que quieras pegar en una web cualquiera que silenciosamente lo envíe a un servidor para “validarlo”. Esta herramienta carga toda la librería de validación Ajv en tu pestaña del navegador y ejecuta cada paso de análisis, compilación y validación localmente. Nada de lo que escribas se transmite, registra ni almacena jamás en ningún sitio, y cerrar la pestaña no deja rastro.
Usos habituales
- Depurar por qué el cuerpo de una petición o respuesta de API falla una prueba de contrato, viendo exactamente qué campo viola el esquema en lugar de un error genérico de “inválido”.
- Comprobar un archivo de configuración contra su JSON Schema publicado antes de desplegar, para detectar pronto una clave con errata o un valor fuera de rango.
- Escribir un nuevo JSON Schema e iterar sobre él con datos de muestra reales hasta que cada campo, tipo y restricción sean exactamente correctos.
- Bootstrapear un primer borrador de esquema a partir de una respuesta de API real o un payload de ejemplo con “Generar un esquema a partir de un ejemplo”, y luego refinarlo a mano.
- Imprimir bonito o minificar primero el propio documento JSON con el Formateador de JSON antes de pegarlo aquí.
- Generar datos de prueba realistas con el Generador de Datos de Prueba para validarlos contra un esquema que estés construyendo.
- Consultar un documento con una expresión JSONPath para encontrar exactamente qué valores incumplen una regla, en lugar de validar todo el esquema. Mira el Probador de JSONPath.
