Validador de JSON Schema

Valida un documento JSON contra un JSON Schema y revisa exactamente dónde falla.

Ejemplos de uso

Comprobar la forma de una respuesta de API

Pega el esquema que promete tu API y una respuesta de ejemplo para confirmar que los campos, tipos y propiedades obligatorias realmente coinciden antes de publicar.

Depurar un archivo de configuración que falla

Cuando una herramienta rechaza tu configuración con un error vago, valídala aquí contra el esquema documentado para ver exactamente qué campo está mal y por qué.

Revisar el contrato de datos de un pull request

Antes de aprobar un cambio en una estructura JSON compartida, pega el esquema actualizado y algunos datos de ejemplo para asegurarte de que nada se rompa silenciosamente.

Validar un archivo de configuración con un esquema documentado

Muchas herramientas de línea de comandos publican un JSON Schema para su archivo de configuración: pega el tuyo junto al esquema publicado para detectar erratas y discordancias de tipo antes de ejecutar la herramienta.

Probar casos límite de un esquema que estás escribiendo

Mientras redactas un esquema nuevo, pega algunos documentos deliberadamente no válidos (sin un campo obligatorio, con un tipo erróneo) para confirmar que tu esquema los rechaza realmente como esperas.

Preguntas frecuentes

¿Qué borrador de JSON Schema se admite?

Esta herramienta valida contra JSON Schema Draft-07, el borrador más compatible y ampliamente soportado. Las palabras clave introducidas solo en borradores posteriores, como 2019-09 o 2020-12 (por ejemplo '$recursiveRef' o la nueva forma de array 'prefixItems'), no se reconocen y pueden ignorarse silenciosamente.

¿Se envía mi esquema o mis datos a un servidor?

No. Tanto el esquema como el documento se validan completamente en tu navegador usando la librería ajv. Nada se sube a ningún sitio.

¿Cuál es la diferencia entre 'Esquema inválido' y un fallo de validación?

'Esquema inválido' significa que el propio JSON Schema está mal formado o es contradictorio y no pudo compilarse, por lo que la validación ni siquiera pudo ejecutarse. Un fallo de validación significa que el esquema se compiló correctamente, pero tu documento no cumple sus reglas; cada regla incumplida se lista con la ruta exacta en tus datos.

¿Cómo interpreto un error como 'en `/user/age`: must be >= 0'?

La ruta muestra dónde está el problema dentro de tu documento JSON, usando '/' para separar claves anidadas e índices de array. El mensaje después de los dos puntos explica qué regla del esquema se incumplió.

¿Puede un esquema hacer referencia a otro esquema con $ref?

Solo dentro del mismo documento pegado, usando JSON Pointers locales del mismo documento (como '#/definitions/address'). Las referencias a archivos externos o a URL no se resuelven, ya que no se descarga nada de la red.

¿Qué exige realmente 'additionalProperties: false'?

Hace que el esquema rechace cualquier objeto que tenga propiedades no listadas explícitamente, lo que es una forma habitual de detectar erratas en los nombres de campo (como 'eamil' en lugar de 'email') que de otro modo pasarían sin avisar.

¿Es válido un esquema vacío ({})?

Sí: un esquema vacío no impone ninguna restricción, así que todos los documentos JSON se validan con éxito contra él.