Validador de JSON Schema

Cómo validar un JSON con un schema

1. Pega tu schema en JSON Schema y tus datos en Documento JSON, o elige un caso preparado en Ejemplo.
2. Deja Draft en Automático ($schema) para usar la versión que indica el $schema del schema, o fuerza el draft 4, 7, 2019-09 o 2020-12.
3. La validación se ejecuta mientras escribes; Validar la vuelve a lanzar. Formatear ambos reindenta los dos textos.
4. Lee el resultado: una línea verde si el documento es válido o, si no, una tabla de errores.

Los mensajes de error del validador están en inglés; las columnas de la tabla y los avisos de la herramienta sí aparecen en español.

Cómo leer la tabla de errores

Cada fila es una regla que no se cumple:

• Ruta en el documento es un JSON Pointer al valor que falla. /roles/1 es el segundo elemento de roles; (raíz) es el documento completo.
• Palabra clave es la regla del schema que falla: type, required, minimum, pattern, format, additionalProperties, etc.
• Mensaje explica el fallo, por ejemplo 0 is less than 1. (0 es menor que 1).
• Ruta en el schema señala la palabra clave dentro del schema, como /properties/id/minimum, para que encuentres la regla rápidamente.

La validación no se detiene en el primer problema: se enumeran todos los errores. Cuando falla una propiedad de un objeto, el validador indica un resumen («Property “id” does not match schema») seguido del motivo concreto. Mostrar solo los errores más específicos oculta esos resúmenes; desmárcalo para ver la cadena completa. Los errores bajo anyOf y oneOf se mantienen siempre junto a los errores específicos de cada rama, porque solo tienen sentido juntos.

Qué se admite

• Drafts: 4, 6 (validado con las reglas del draft 7), 7, 2019-09 y 2020-12, incluidos $defs/definitions, $ref locales, if/then/else, dependentRequired, dependentSchemas, prefixItems, unevaluatedProperties y unevaluatedItems.
• Formatos: se comprueban date, time, date-time, duration, email, hostname, ipv4, ipv6, uri, uri-reference, uri-template, uuid, regex, json-pointer y relative-json-pointer. Los formatos desconocidos se ignoran, como permite la especificación.
• Referencias: $ref puede apuntar a cualquier parte del schema, incluido un $id que este declare. Los schemas remotos nunca se descargan; una referencia a otra URL se indica como no resuelta.

Esta herramienta valida documentos según tu schema. No comprueba que el propio schema siga el metaschema, pero avisa de los nombres de type desconocidos, como "strin" o "int", una errata frecuente que los validadores suelen ignorar sin decir nada.

Los ejemplos

• Perfil de usuario (2020-12): required, longitudes de cadena, format: email, un enum dentro de items, uniqueItems y additionalProperties: false.
• Lista de productos con $ref (draft-07): un array cuyos elementos hacen referencia a #/definitions/product, con un pattern para el SKU y un precio con exclusiveMinimum.
• Configuración con if/then (2019-09): un certificado obligatorio solo en modo HTTPS, un oneOf entre correo electrónico y URI, y límites numéricos.

Cada ejemplo incluye un documento con errores deliberados, para que veas cómo se presentan los errores.