Generador de esquema JSON

Un esquema JSON es un vocabulario que permite anotar y validar documentos JSON. Describe la estructura, tipos y restricciones de tus datos JSON, facilitando la validación de entradas, la generación de documentación y el intercambio de contratos de datos entre servicios.

Esta herramienta genera JSON Schema Draft-07, que es la versión más ampliamente compatible. Draft-07 es compatible con la mayoría de validadores, editores y herramientas de API actuales, incluidos VS Code, Postman y OpenAPI 3.x.

La herramienta inspecciona recursivamente cada valor en tu JSON. Para cada clave determina el tipo JSON (string, number, integer, boolean, array, object o null), recopila todas las claves únicas en objetos y las marca como requeridas. Los tipos de elementos de array se infieren del primer elemento. No se envían datos al servidor.

Por defecto, cada clave presente en el JSON de muestra se añade al array "required". Si tus datos reales pueden tener campos opcionales, simplemente elimina esas claves del array required en el esquema generado antes de usarlo.

Cuando un valor es null en el JSON de muestra, la herramienta genera un tipo "null". Si el campo puede contener otros tipos también, debes cambiar manualmente el tipo a un array como ["string", "null"] tras generar el esquema.

Sí. Si tu JSON es un array de nivel superior, el esquema generado tendrá tipo "array" con un sub-esquema "items" inferido del primer elemento. Esto modela correctamente colecciones de objetos uniformes.

No. Todo el procesamiento ocurre completamente en tu navegador usando JavaScript del lado del cliente. Tu JSON nunca se transmite a nuestros servidores, por lo que los datos sensibles permanecen privados.

Sí. OpenAPI 3.x usa un superconjunto de JSON Schema Draft-07, por lo que el resultado de esta herramienta puede pegarse directamente en la sección "schema" de un componente OpenAPI con ajustes menores.

La herramienta admite completamente estructuras JSON anidadas arbitrariamente. Cada objeto anidado obtiene su propio bloque "properties" con anotaciones de tipo correctas, y la profundidad de anidamiento no tiene límite duro.

JSON Schema distingue entre "integer" (números enteros como 1, 42, -7) y "number" (cualquier valor numérico incluyendo decimales como 3.14). Esta herramienta usa automáticamente "integer" cuando el valor no tiene parte fraccionaria, y "number" en caso contrario.

Absolutamente. El resultado es texto editable. Las personalizaciones comunes incluyen añadir campos "description", restringir cadenas con "minLength"/"maxLength" o "pattern", añadir arrays "enum" y ajustar la lista "required".

Cuando está habilitada, se añade "additionalProperties: false" a cada objeto en el esquema. Esto le indica a los validadores que rechacen cualquier clave no listada explícitamente en "properties". Es útil para contratos de API estrictos.