Generador de JSON Schema
Genere JSON Schema a partir de datos JSON automáticamente
Inferido a partir de los datos de ejemplo. Los esquemas de los elementos de un arreglo usan el primer elemento; revise y ajuste el esquema antes de validar.
Se procesa en este dispositivo. Su texto no se sube.
Generador de JSON Schema en línea gratis
Este generador de JSON Schema analiza datos JSON de ejemplo y produce al instante una definición válida de JSON Schema, con detección precisa de tipos, manejo de objetos anidados e inferencia de los elementos de los arreglos. Solo pegue un objeto JSON, elija la versión de borrador que prefiera y obtenga un esquema que puede usar para la validación de API, la generación de formularios o la documentación, sin escribir a mano ni una línea de código de esquema.
La herramienta admite JSON Schema draft-04, draft-06 y draft-07, las versiones más adoptadas del ecosistema. Recorre de forma recursiva su estructura JSON y detecta cadenas, números, enteros, booleanos, nulos, objetos y arreglos. En los arreglos, el esquema se infiere a partir del primer elemento, lo que garantiza definiciones de elementos precisas incluso en estructuras anidadas complejas.
Las opciones configurables permiten activar los arreglos de propiedades requeridas, añadir marcadores de descripción para la documentación y aplicar additionalProperties: false para una validación estricta. Cuando el resultado le convenza, descárguelo como archivo .schema.json o cópielo al portapapeles con un clic. Todo se ejecuta localmente en su navegador: sus datos nunca se suben a un servidor.
Características principales
- Compatibilidad con JSON Schema draft-04, draft-06 y draft-07 con el URI $schema correcto
- Detección automática de tipos: string, number, integer, boolean, null, object y array
- Generación recursiva de esquemas para objetos y arreglos muy anidados
- Inferencia del tipo de los elementos de un arreglo a partir del primer elemento
- Arreglos de propiedades «required» configurables para controlar el rigor de la validación
- Generación opcional de marcadores «description» para esquemas autodocumentados
- Interruptor para «additionalProperties: false» que impone formas de objeto estrictas
- Descargue el esquema generado como archivo .schema.json
- Copia con un clic al portapapeles
- JSON de ejemplo precargado para experimentar rápidamente
Cómo usar el Generador de JSON Schema
- Configure las opciones del esquema: seleccione la versión del borrador y active o desactive los arreglos required, las descripciones y additionalProperties según sus necesidades.
- Pegue su JSON: escriba o pegue un objeto JSON de ejemplo en el panel de entrada. También puede hacer clic en «JSON de ejemplo» para cargar un ejemplo.
- Genere el esquema: haga clic en «Generar esquema» para producir el JSON Schema en el panel derecho.
- Revise y ajuste: inspeccione el resultado. Modifique opciones como los campos requeridos o las descripciones y vuelva a generar el esquema según haga falta.
- Exporte el esquema: haga clic en «Copiar» para llevar el esquema al portapapeles o en «Descargar .schema.json» para guardarlo como archivo.
Casos de uso
- Especificaciones OpenAPI / Swagger: genere definiciones de esquema para los cuerpos de solicitud y respuesta en la documentación de su API.
- Validación de solicitudes en el backend: cree esquemas para validar las cargas JSON entrantes en Express, FastAPI, Spring Boot u otros frameworks.
- Generación de formularios en el frontend: use los esquemas con bibliotecas como react-jsonschema-form para generar automáticamente formularios de interfaz a partir de modelos de datos.
- Contratos de datos: defina y comparta contratos de datos estructurados entre microservicios o entre equipos de frontend y backend.
- Validación de configuración: valide archivos de configuración JSON en pipelines de CI/CD para detectar errores estructurales antes del despliegue.
- Planificación de migraciones de bases de datos: documente las formas de datos esperadas al diseñar nuevas tablas o colecciones.
- Autocompletado en el IDE: haga referencia a un JSON Schema en los ajustes de VS Code para habilitar IntelliSense y validación en archivos JSON personalizados.
Preguntas frecuentes
¿Esta herramienta es gratuita?
Sí, el generador de JSON Schema es totalmente gratuito, sin registro ni límites de uso. Genere esquemas para cualquier cantidad de objetos JSON sin costo.
¿Mis datos están seguros?
Sí. Toda la generación de esquemas se hace en su navegador. Sus datos JSON nunca se envían a ningún servidor, por lo que puede usar la herramienta con cargas de API propietarias o estructuras de datos internas.
¿Qué es JSON Schema?
JSON Schema es un vocabulario declarativo para anotar y validar documentos JSON. Describe la estructura esperada, los tipos de datos, las propiedades requeridas y las restricciones de un objeto JSON. Se usa ampliamente en especificaciones de API (OpenAPI/Swagger), bibliotecas de generación de formularios y herramientas de validación de configuración.
¿Qué versión de borrador debo usar?
Se recomienda draft-07 para la mayoría de los proyectos, ya que es la versión con mayor compatibilidad entre bibliotecas de validación y herramientas. Use draft-04 o draft-06 solo si su cadena de herramientas exige específicamente una versión anterior.
¿Puedo editar el esquema generado?
El esquema generado es un punto de partida. Después de descargarlo o copiarlo, puede añadir manualmente restricciones como minLength, maximum, valores enum o expresiones regulares pattern que no se pueden inferir solo a partir de datos de ejemplo.
¿Maneja arreglos con tipos mixtos?
El generador infiere los tipos de los elementos del arreglo a partir del primer elemento. Si su arreglo contiene tipos mixtos, es posible que deba ajustar manualmente la definición de items a un esquema oneOf o anyOf después de la generación.
Consejos y buenas prácticas
- Proporcione datos de ejemplo representativos: incluya todos los campos posibles en su JSON de ejemplo para que el esquema capture la estructura completa.
- Active los arreglos required: habilite la opción «required» para exigir los campos obligatorios cuando use el esquema para validar.
- Añada las descripciones después: habilite los marcadores de descripción durante la generación y luego reemplácelos por documentación real antes de compartir el esquema.
- Use additionalProperties: false en API estrictas: esto impide que los clientes envíen campos inesperados que podrían causar problemas más adelante.
- Valide después de generar: pruebe su esquema con varias cargas de ejemplo usando un validador de JSON Schema para asegurarse de que cubre los casos límite.
- Versione sus esquemas: guarde los archivos de esquema en el control de versiones junto con el código de su API para seguir los cambios a lo largo del tiempo.