Validador de JSON Schema

Esta herramienta es compatible con JSON Schema Draft-07, Draft 2019-09 y Draft 2020-12 a través de la biblioteca Ajv. La mayoría de las características comunes de esquemas son compatibles.

¡Sí! JSON Schema es compatible con objetos y arrays profundamente anidados. Puedes definir propiedades y elementos en cualquier nivel de anidamiento, con reglas de validación individuales para cada campo.

La herramienta primero valida que tu esquema sea un JSON Schema válido. Si el esquema tiene errores, estos se informarán antes de intentar validar los datos.

type (string, number, object, array, boolean, null), properties con esquemas anidados, required que enumera las claves obligatorias, enum para conjuntos de valores fijos, pattern para cadenas restringidas por expresiones regulares, y las comprobaciones de rango minimum/maximum y minLength/maxLength. additionalProperties: false endurece los objetos frente a claves adicionales. En conjunto cubren la mayor parte de las reglas de validación de API.

En JSON Schema moderno, format es una anotación por defecto, no una aserción automática - los validadores la aplican solo cuando están configurados para hacerlo, algo que la especificación 2020-12 hizo explícito con un vocabulario format-assertion separado. Usa pattern o una palabra clave personalizada cuando deba garantizarse su cumplimiento, y trata format como metadatos de interoperabilidad en los demás casos.

Un $ref que apunta a #/$defs/address referencia un fragmento de esquema bajo $defs y valida contra él dondequiera que se use - el mecanismo de deduplicación. Draft 2020-12 renombró el antiguo definitions a $defs y formalizó $dynamicRef para estructuras recursivas como los árboles de comentarios. Las referencias también pueden apuntar a documentos externos, aunque es más común empaquetarlas localmente.

allOf exige que todos los subesquemas validen - una intersección, usada para componer un esquema base con restricciones adicionales. anyOf exige al menos uno - una unión, usada para payloads polimórficos. oneOf exige exactamente uno; validar dos o ninguno hace fallar la validación, lo cual es más estricto de lo que la gente espera y la causa habitual de errores sorprendentes con esquemas superpuestos.

2020-12 dividió la especificación en vocabularios negociables por separado (validation, annotation, format-assertion), renombró definitions a $defs, simplificó exclusiveMinimum a un número simple y reemplazó la antigua palabra clave items por prefixItems más items. La mayoría de las herramientas admite ambos; draft-07 sigue siendo el más desplegado, pero 2020-12 es el estándar publicado vigente.