Generador de esquema JSON
Generar JSON Schema automáticamente desde datos JSON
Entrada JSON
Esquema generado
¿Qué es un generador de esquema JSON?
¿Alguna vez tuviste que escribir un JSON Schema desde cero a mano? Es tedioso. Esta herramienta lo hace por ti — pega un objeto JSON de ejemplo y al instante genera un esquema que describe esa estructura: tipos, propiedades, campos requeridos y objetos anidados. El esquema generado sigue las convenciones JSON de RFC 8259 y es compatible con herramientas como Ajv. Úsalo para arrancar la documentación de tu API, validar pipelines de datos o crear esquemas para especificaciones OpenAPI.
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 Copiar o Descargar para obtener el esquema. Para validar JSON contra un esquema, usa el Validador JSON o una biblioteca como Ajv.
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.
Ejemplo: Generar un esquema a partir de un objeto de usuario
Entrada JSON:
{
"id": 1,
"name": "Alice",
"email": "[email protected]",
"age": 30,
"active": true
}JSON Schema generado:
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": { "type": "integer" },
"name": { "type": "string" },
"email": { "type": "string" },
"age": { "type": "integer" },
"active": { "type": "boolean" }
}
}Preguntas frecuentes
¿Puedo validar JSON con este esquema?
Esta herramienta solo genera esquemas. Para validar, usa el Validador JSON o una biblioteca como Ajv 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.