JSON a esquema Zod
Crea un esquema de Zod a partir de un JSON de ejemplo. La salida incluye import { z } from 'zod', un esquema z.object({...}) y una línea que extrae el tipo con z.infer, de modo que puedes pegarlo y validar una respuesta de API u otro dato con schema.parse(data). Cuando los elementos de un array tienen formas distintas se fusionan en uno, una clave presente solo en algunos elementos pasa a .optional() y un valor como cadena o null pasa a .nullable(). Un array vacío pasa a z.array(z.unknown()). Los números, enteros o no, son z.number() y las cadenas de fecha son z.string(), así que añade tú .int(), .datetime() y restricciones como longitud y rango. Infiere a partir de una sola muestra. Todo se procesa en tu navegador y tu JSON no se envía.
Otros validadores: Valibot y JSON Schema
Crea un esquema de Valibot o un JSON Schema (draft 2020-12) a partir del mismo JSON. Los elementos de un array se fusionan, las claves que faltan en algunos objetos pasan a ser opcionales y se aplican las opciones de formatos de cadena y de nombre raíz de arriba.
GuíaCómo usarlo y características
- Pega el JSON en el campo de entrada y pulsa «Convertir a Zod».
- Los objetos se formatean como bloques `z.object({...})` con el anidado correspondiente.
- Las matrices infieren el tipo de sus elementos; si hay mezcla se usa `z.union([...])`.
- Usa los botones de copiar o limpiar para reutilizar el esquema o empezar de nuevo.
EjemplosEjemplos de entrada y salida
Convert JSON to Zod schema
{"id":42,"enabled":false,"labels":["alpha","beta"]}const Schema = z.object({
id: z.number(),
enabled: z.boolean(),
labels: z.array(z.string()),
});FAQPreguntas frecuentes
¿Qué código genera?
Tres cosas: `import { z } from 'zod'`, un esquema `z.object({...})` y una línea que extrae el tipo con `z.infer`. Pégalo en tu proyecto y valida con `schema.parse(data)`.¿Qué pasa cuando los elementos de un array tienen formas distintas?
Se fusionan en un solo tipo. Una clave que solo tienen algunos elementos pasa a `.optional()`. Se usa `z.union` solo cuando difiere el tipo de valor, como una cadena y un número.¿Cómo se trata `null`?
Un caso como "cadena o null" recibe `.nullable()`. Una clave cuyo único valor es `null` pasa a `z.null()`.¿Los enteros y las fechas se convierten en `.int()` y `.datetime()`?
No. Los números, enteros o no, son `z.number()` y las cadenas de fecha son `z.string()`. Añade a mano el ajuste que necesites.¿Qué ocurre con un array vacío?
No se conoce el tipo del elemento, así que pasa a `z.array(z.unknown())`. Sustitúyelo por el tipo real.¿Se envía mi JSON a algún sitio?
No. La conversión se hace por completo en tu navegador.
Casos de usoUsos habituales
Redactar la validación de formularios
Genera esquemas de Zod a partir de ejemplos del backend y colócalos de inmediato en la lógica de validación del front-end.Verificar datos simulados
Analiza con Zod el JSON simulado local para detectar en tiempo de ejecución campos o formas inesperados.Compartir fragmentos de esquema
Copia los fragmentos generados para reutilizarlos entre bibliotecas y mantener las comprobaciones en tiempo de ejecución alineadas con los tipos.
NotasNotas y limitaciones
Infiere a partir de una sola muestra
Solo mira la forma de los valores de tu JSON. No puede conocer rangos, enumeraciones, longitudes ni formatos como el correo. Ajusta el resultado a tu especificación.Que una clave sea obligatoria depende de la muestra
Las claves presentes en todos los elementos del array son obligatorias y las que solo están en algunos pasan a `.optional()`. Comprueba que coincide con la especificación real.No se añade ajuste de enteros ni de fechas
Obtienes `z.number()` y `z.string()` simples. Añade `.int()` o `.datetime()` donde lo necesites.La entrada debe ser JSON estricto
Los comentarios, las comas finales y otra sintaxis que no sea JSON producen un error. Los enteros grandes que JavaScript no puede representar con exactitud se redondean.
Acerca deAcerca de esta herramienta
Generador de esquemas Zod desde JSON
Genera un esquema Zod a partir de una muestra JSON para validar datos en tiempo de ejecución. Es útil cuando recibes datos externos desde APIs, formularios, webhooks o almacenamiento local y quieres comprobar su forma antes de usarlos.
Casos de uso
- Validar APIs externas: crea un punto de partida desde una respuesta real.
- Proteger límites de entrada: revisa datos antes de pasarlos a la aplicación.
- Preparar tests: documenta el formato esperado con un schema claro.
El resultado se infiere desde la muestra. Ajusta campos opcionales, enums y valores nulos según el contrato real.
Artículos para esta herramienta
Simplifique la validación de JSON con Zod
Automatice la validación en tiempo de ejecución y la generación de tipos para datos JSON con Zod, una biblioteca de esquemas compatible con TypeScript.
Convertir entre JSON Schema y Zod: cómo se corresponden required y .optional()
Conversor bidireccional entre JSON Schema y Zod: valores por defecto invertidos de required y .optional(), tabla de restricciones y análisis sin ejecutar código.
El ecosistema JSON: conectando formato, tipos, validación y especificación de API
Sigue una respuesta de API por el formateo, los tipos de TypeScript, la validación con Zod y las definiciones OpenAPI, con código real en cada paso.
Cómo generar tipos de TypeScript a partir de JSON: guía práctica con ejemplos
Convierte el JSON de respuestas de API en interfaces TypeScript seguras, con ejemplos reales: null, arreglos, anidamiento, nombres y cuándo editar a mano.
Formatear y validar JSON: cómo revisar respuestas de API con seguridad
Aprende a formatear JSON, detectar errores de sintaxis, revisar tipos de valores y convertir respuestas de API en tipos, esquemas o documentación.
