Conversor JSON Schema ⇄ Zod
Un conversor bidireccional: genera un esquema de Zod a partir de JSON Schema, o escribe JSON Schema a partir de código de Zod. Asocia en ambos sentidos required con .optional(), los enums, las uniones (oneOf / anyOf), los objetos anidados, ["string", "null"] con .nullable(), additionalProperties: false con .strict(), y los formatos de cadena (email, uri, uuid, date-time) junto con las restricciones de longitud, patrón y rango numérico. Un $ref dentro del mismo archivo (incluida la recursión) pasa a ser una definición con nombre, allOf pasa a .and(), y también se convierten las tuplas, default y description. Lo que no se puede convertir, como un $ref a un archivo externo o if/then, se trata como any y se indica como advertencia. El código de Zod solo se lee, nunca se ejecuta. Todo se procesa en tu navegador y el esquema que pegas nunca se envía.
Crear un JSON Schema a partir de un JSON de ejemplo
Pega un JSON de ejemplo y obtén un JSON Schema (2020-12) que lo describe: tipos, claves obligatorias, valores nulos y formatos. Las claves ausentes en algunos elementos de un arreglo pasan a ser opcionales.
GuíaCómo usarlo y características
- Elija «JSON Schema → Zod» y pegue un esquema para obtener una definición `z.object({ ... })` junto con un alias de tipo `z.infer`.
- Elija «Zod → JSON Schema» para el sentido inverso. Las líneas `import` y `export const user =` no molestan: el analizador toma la expresión que empieza en `z.`.
- Las propiedades ausentes de `required` reciben `.optional()`, y en sentido inverso todo lo que no lleve `.optional()` pasa a `required`.
- Los detalles de cadena también se corresponden: `format: "email"` se convierte en `.email()` y `minLength` en `.min()`.
- Lo que no se puede convertir, como `$ref` o `allOf`, aparece como advertencia bajo el resultado en lugar de generar en silencio una salida rota.
FAQPreguntas frecuentes
¿En qué se diferencia de la herramienta JSON to Zod?
En la entrada. JSON to Zod deduce los tipos a partir de un valor de ejemplo, como una respuesta de API, así que no puede saber qué campos son obligatorios ni qué formatos de cadena se aplican. Esta herramienta parte del propio JSON Schema, de modo que restricciones como required, enum, minLength y format:email se trasladan a la cadena de Zod (.optional() / .enum() / .min() / .email()). Si ya tiene una definición OpenAPI o JSON Schema, esta es la vía precisa.¿Cómo se corresponden required y .optional()?
Los valores por defecto están invertidos. JSON Schema considera obligatoria una propiedad solo si aparece en el array required, mientras que Zod la considera obligatoria salvo que lleve .optional(). El conversor absorbe esa diferencia: hacia Zod, las propiedades ausentes de required reciben .optional(); en sentido inverso, las que no llevan .optional() se recogen en el array required.¿Puede convertir esquemas que usan $ref?
Sí, para las referencias dentro del mismo archivo ($defs o definitions, incluida la recursión): pasan a ser definiciones con nombre. Una referencia a un archivo externo o a una ruta inexistente pasa a ser z.any() con un aviso, así que si tus definiciones compartidas están en otro archivo, únelas en uno solo antes de pegar.¿Puedo usar el esquema Zod generado para validar en producción?
Sirve como esqueleto, pero las reglas de negocio que nunca estuvieron en el JSON Schema —dominios de correo permitidos, coherencia entre campos— no aparecerán. Tenga en cuenta además que pattern se convierte en z.string().regex(), que puede comportarse de otro modo si la expresión regular original no es compatible con ECMAScript. Revise siempre el resultado.
Casos de usoCasos de uso habituales
Convertir una definición OpenAPI en tipos y validación de front-end
La sección components.schemas de OpenAPI es JSON Schema, así que pegarla aquí le da un esquema de Zod y un tipo z.infer de una vez, evitando que el contrato del servidor y la validación del cliente se separen.Exportar un esquema Zod existente como contrato de API
Si el esquema Zod llegó primero en su código, ejecute la conversión inversa para obtener JSON Schema y llevarlo a los components de OpenAPI o a su documentación.Migrar validaciones escritas a mano a un enfoque basado en esquemas
Al sustituir un montón de sentencias if, un JSON Schema existente le da un punto de partida completo en Zod, con muchos menos campos obligatorios y enums olvidados.Hacer utilizable un JSON Schema generado por IA
Pegue el esquema que produjo un LLM y conviértalo en un esquema de Zod que realmente compile, obteniendo tipos estáticos y validación en tiempo de ejecución.
NotasNotas y limitaciones
Un $ref del mismo archivo se expande, pero no las referencias externas ni los condicionales
Un $ref dentro del mismo archivo ($defs, definitions, recursión) se expande en definiciones con nombre, y allOf pasa a ser una intersección con .and(). Un $ref a un archivo externo, if/then/else, not y patternProperties no se admiten y se muestran como avisos bajo el resultado para que completes esas partes a mano.Zod → JSON Schema analiza el código como texto
Para que todo ocurra en el navegador, el código nunca se ejecuta: se analiza como texto. Se admiten z.object / z.array / z.union / z.enum / z.literal / z.record y las cadenas de métodos habituales, pero un esquema referenciado mediante una variable, o una función arbitraria como .refine(), no puede representarse en JSON Schema y se ignora.Las expresiones regulares de pattern se trasladan tal cual
Un pattern de JSON Schema se convierte en z.string().regex(), y en sentido inverso su contenido vuelve a pattern. JSON Schema permite expresiones regulares no compatibles con ECMAScript, así que un traslado directo puede cambiar el comportamiento.Revise siempre el resultado generado
Esta herramienta produce un punto de partida para una migración. Las reglas de negocio y las comprobaciones de coherencia entre campos no se generan salvo que estuvieran en el esquema original; revise el resultado antes de usarlo en producción.
