Generador de esquema JSON
Generar JSON Schema automáticamente desde datos JSON
Entrada JSON
Esquema generado
¿Qué es un generador de esquema JSON?
JSON Schema describe la estructura de los datos JSON: campos requeridos, tipos, valores permitidos, formatos. Un generador de esquemas infiere un esquema a partir de JSON de ejemplo. Pegas datos de ejemplo y produce un esquema que describe esa estructura. Luego puedes usar el esquema para validar otro JSON o documentar APIs.
Esta herramienta se ejecuta en tu navegador. Pega tu JSON y genera un borrador de JSON Schema. No se envía nada a ningún servidor.
Cómo usar esta herramienta
Pegar JSON de ejemplo
Pega JSON que represente la estructura que quieres describir. Usa Ejemplo o Subir si es necesario. El generador infiere tipos de los valores (string, number, boolean, array, object).
Revisar el esquema
El panel derecho muestra el esquema generado. Puede incluir type, properties, required y esquemas anidados para objetos. Puedes editarlo manualmente si es necesario.
Copiar o descargar
Usa <strong>Copiar</strong> o <strong>Descargar</strong> para obtener el esquema. Para validar JSON contra un esquema, usa el Validador JSON o una biblioteca como <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>.
Ejemplos de JSON Schema
Genera un esquema a partir de JSON de ejemplo. Ejemplo de telecomunicaciones:
Entrada JSON
Esquema generado
Cuándo usar un esquema generado
Los esquemas generados son un punto de partida. Capturan la estructura de tus datos de ejemplo pero pueden ser demasiado estrictos o demasiado flexibles. Puede que necesites añadir arrays required, ajustar tipos o añadir enum para valores permitidos. La documentación de JSON Schema explica el vocabulario completo. Para documentación de API, herramientas como OpenAPI pueden referenciar JSON Schema.
Preguntas frecuentes
¿Puedo validar JSON con este esquema?
Esta herramienta solo genera esquemas. Para validar, usa el Validador JSON o una biblioteca como <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a> en tu código.
¿Qué pasa si mi JSON tiene formas diferentes?
El generador infiere del ejemplo que proporciones. Si tu JSON puede tener múltiples formas (ej. campos opcionales), el esquema puede necesitar ediciones manuales. Usa oneOf o anyOf para variantes.
¿Se envían mis datos a algún sitio?
No. La generación se ejecuta en tu navegador.
¿Qué borrador de JSON Schema se usa?
La herramienta puede usar draft-07 o draft-2020-12. Revisa el esquema generado para $schema y ver la versión. La especificación JSON Schema tiene los detalles.
¿Puedo usar esto para respuestas de API?
Sí. Pega una respuesta típica de API. El esquema generado describe esa estructura. Luego puedes usarlo en OpenAPI/Swagger o para documentación.
Herramientas relacionadas
Más información en json-schema.org y JSON Schema learn. Para validación en código, ver Ajv. Para JSON, ver json.org, MDN y RFC 8259. Para documentación de API, ver OpenAPI.