Este convertidor en línea (JavaScript class → JSON Schema) te ayuda a generar JSON Schema desde modelos reales (DTOs, structs y classes) para validar payloads, compartir contratos y generar mock JSON.
Paso 1 – Pega tu fuente JavaScript
- Pega los modelos que quieres documentar en el editor izquierdo.
- Incluye tipos referenciados en el mismo snippet para que el esquema pueda generar definitions.
- Usa el botón Ejemplo para cargar un ejemplo y ver el formato esperado.
Paso 2 – Selecciona el Tipo raíz (si hace falta)
- Si se detectan múltiples definitions, elige la raíz que coincide con tu payload de API.
- El esquema de salida se construye alrededor de la raíz seleccionada e incluye definitions para tipos referenciados.
Paso 3 – Revisa la salida de JSON Schema
- Comprueba tipos, campos requeridos vs. opcionales y estructuras anidadas de objetos/arrays.
- Busca
definitions y $ref cuando tus modelos referencien otros modelos. - Copia o descarga el esquema para validación, documentación o desarrollo schema-first.
Paso 4 – Valida o genera mock JSON
- Haz clic en Generar datos mock para abrir el generador de mock con tu esquema precargado.
- Valida payloads reales contra tu esquema para detectar cambios incompatibles temprano.
- Si dependes de composición avanzada del schema (por ejemplo
anyOf/oneOf/allOf), verifica el resultado con un validador completo como Ajv.
Nota sobre soporte de keywords
Los esquemas generados pueden incluir $ref y puedes editarlos para añadir anyOf, oneOf, o allOf. Para esquemas complejos, usa un validador completo de JSON Schema y haz dereference antes de generar mock si es necesario.