Genera JSON Schema Draft-07 automáticamente a partir de cualquier JSON
El schema aparecerá aquí cuando ingreses un JSON válido
JSON Schema es un vocabulario que permite describir y validar la estructura de datos JSON. Es usado por validadores como Ajv, editores como VS Code para autocompletado, herramientas de documentación de API como Swagger/OpenAPI, y generadores de tipos TypeScript como json-schema-to-typescript. Escribir JSON Schema a mano es tedioso y propenso a errores — esta herramienta lo genera automáticamente analizando un JSON de ejemplo e infiriendo los tipos de cada campo. Para objetos, detecta todas las propiedades y sus tipos (string, number, boolean, null, array, object). Para arrays, analiza el primer elemento para inferir el schema de los items. Para objetos anidados, genera schemas recursivos. La opción 'required' marca todas las propiedades actuales como obligatorias según el schema Draft-07. El schema generado cumple con la especificación JSON Schema Draft-07 (la más compatible, usada por Ajv 6 y VS Code) e incluye la propiedad $schema para autodescripción.
¿Qué es JSON Schema y para qué sirve?
JSON Schema es un vocabulario estándar que describe la estructura y restricciones de documentos JSON. Sirve para: validar que los datos JSON cumplen un contrato (con librerías como Ajv, Joi, Zod), documentar APIs REST indicando qué campos acepta cada endpoint, generar tipos TypeScript con herramientas como json-schema-to-typescript, y activar autocompletado en editores como VS Code cuando se referencia el schema en archivos de configuración JSON.
¿Por qué Draft-07 y no Draft-2020?
Draft-07 es la versión con mayor compatibilidad en el ecosistema actual: es la que usa Ajv 6 (el validador más popular), VS Code, Swagger/OpenAPI 3.0 y la mayoría de herramientas de generación de código. Draft-2020-12 (la más reciente) tiene soporte limitado en la práctica y requiere Ajv 8 con configuración específica. Para la mayoría de casos de uso reales, Draft-07 es la elección pragmática.
¿Puede la herramienta inferir restricciones como min/max?
Esta herramienta infiere tipos básicos (string, number, boolean, null, array, object) a partir de los valores del ejemplo. No infiere restricciones semánticas como minimum/maximum para números, minLength/maxLength para strings, o pattern para validación con regex — esas restricciones dependen del dominio de negocio, no del valor de ejemplo. El schema generado es un punto de partida que puedes refinar añadiendo estas restricciones manualmente.
¿Qué pasa si el JSON tiene arrays con tipos mixtos?
La herramienta infiere el schema del primer elemento del array para determinar el tipo de 'items'. Si el array tiene elementos de tipos diferentes (mixto), el schema resultante puede no ser perfectamente preciso. Para arrays mixtos, deberías editar manualmente el schema para usar 'oneOf' o 'anyOf' con los distintos tipos posibles, o usar 'items: {}' para aceptar cualquier tipo.
¿El schema generado valida JSON correctamente con Ajv?
Sí, el schema generado es válido JSON Schema Draft-07 y puede usarse directamente con Ajv. Ten en cuenta que el schema infiere tipos pero no restricciones de negocio — un campo inferido como 'string' aceptará cualquier string, no solo los valores válidos para ese campo en tu dominio. Considera el output como el esqueleto base de tu schema real.