Puntos clave
- 01Impulsado por Ajv, el validador de JSON Schema de JavaScript más utilizado — lo que pasa aquí pasa en Node.js, Fastify y la mayoría de cadenas de herramientas JS.
- 02Reporta cada error de validación a la vez (modo allErrors), no solo el primer fallo.
- 03Cada error incluye la ruta JSON Pointer al campo que falla para una navegación rápida.
- 04Tanto el schema como los datos se ejecutan completamente en tu navegador — nada se carga.
¿Por Qué Validar JSON Contra un Schema?
JSON Schema es la forma estándar de describir la estructura de un documento JSON — campos requeridos, tipos permitidos, restricciones de valores, estructuras de objetos anidados. Validar contra un schema antes de que una carga útil llegue a producción detecta desajustes de tipos, campos requeridos faltantes y violaciones de restricciones temprano, cuando son baratos de arreglar.
Los casos de uso más comunes son probar cuerpos de solicitud y respuesta de API, validar archivos de configuración, verificar objetos de ejemplo de OpenAPI y verificar exportaciones de datos contra una estructura conocida. El validador de Handytool usa Ajv — la biblioteca de JSON Schema de JavaScript de facto, utilizada dentro de Node.js mismo — por lo que los resultados aquí coinciden con lo que tu backend verá.
Cómo Validar JSON Contra un Schema
- 01
Pega tu JSON Schema
Pega el schema en el panel izquierdo. Puede ser un schema Draft 7 o 2019-09 o 2020-12 con type, properties, required, items, anyOf, allOf — cualquier palabra clave estándar compatible con Ajv.
- 02
Pega tus datos JSON
Pega el documento de datos que deseas validar en el panel derecho. Esta es la instancia — un cuerpo de solicitud de API, un objeto de configuración, un registro de exportación o un único ejemplo de tu spec OpenAPI.
- 03
Haz clic en Validar
Ajv ejecuta la validación con allErrors: true, lo que significa que recopila cada fallo en lugar de detenerse en el primero.
- 04
Revisa la lista de errores
Cada error muestra la ruta JSON Pointer al valor que falla (p. ej. /user/email), la palabra clave que falla (type, required, minimum) y un mensaje legible por humanos. Arregla cada uno y revalida.
Lo Que los Desarrolladores Validan Con JSON Schema
- 01Cuerpos de solicitud de API REST — confirma que una carga útil coincida con la forma esperada del endpoint antes de enviar.
- 02Objetos de ejemplo de spec OpenAPI — valida cada ejemplo contra el componente de schema incorporado.
- 03Archivos de configuración — asegúrate de que las claves requeridas estén presentes y los valores sean del tipo correcto.
- 04Registros de canalización de datos — detecta cambios estructurales entre productores y consumidores de datos.
- 05Cargas útiles de envío de formularios — prueba que la validación del frontend refleje las restricciones de schema del backend.
- 06Cuerpos de webhook de terceros — confirma que el schema documentado coincida con la carga útil real.
Validación Privada, Sin Servidor Requerido
Ajv se ejecuta completamente en tu navegador. Ni el schema ni los datos se envían a ningún servidor — puedes validar de forma segura schemas que describen estructuras de datos internas y objetos de datos que contienen valores de campos sensibles.
El validador admite borradores de JSON Schema 6, 7, 2019-09 y 2020-12. El borrador más común en la naturaleza es Draft 7, que cubre todas las palabras clave cotidianas: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not y $ref.
Preguntas Frecuentes del Validador de JSON Schema
¿Qué borradores de JSON Schema se admiten?
Ajv admite los borradores 6, 7, 2019-09 y 2020-12. Draft 7 es el más común en bases de código existentes y cubre todas las palabras clave estándar.
¿Por qué mi schema $ref no se resuelve?
Las URLs externas de $ref no se obtienen en esta herramienta solo de navegador. Incorpora todos los schemas referenciados usando $defs y punteros JSON locales como #/$defs/MyType.
¿Se carga mi schema o datos en algún servidor?
No. Ajv se ejecuta completamente en tu navegador — tanto el schema como los datos permanecen en tu dispositivo.
¿Puedo usar esto para validar un spec OpenAPI 3?
Puedes validar componentes de schema individuales y objetos de ejemplo. Validar el documento OpenAPI completo requiere un validador OpenAPI dedicado que entienda el meta-schema de la especificación.
¿Por qué veo múltiples errores en lugar de solo el primero?
El validador está configurado con allErrors: true, lo que hace que Ajv recopile cada fallo en lugar de detenerse en el primero. Esto es intencional — puedes arreglar todos los problemas en un solo paso en lugar de hacer intentos de validación repetidos.