Convertidor de JSON a esquema Zod

¿Qué es un esquema Zod?

Ejemplos

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

import { z } from "zod";

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  email: z.string(),
  active: z.boolean(),
  roles: z.array(z.string()),
});

export type Root = z.infer<typeof RootSchema>;

{"repo":"zod","owner":{"login":"colinhacks","id":100}}

import { z } from "zod";

export const OwnerSchema = z.object({
  login: z.string(),
  id: z.number().int(),
});

export const RootSchema = z.object({
  repo: z.string(),
  owner: OwnerSchema,
});

export type Root = z.infer<typeof RootSchema>;

{"users":[{"id":1,"nick":"x"},{"id":2}]}

import { z } from "zod";

export const UserSchema = z.object({
  id: z.number().int(),
  nick: z.string().optional(),
});

export const RootSchema = z.object({
  users: z.array(UserSchema),
});

export type Root = z.infer<typeof RootSchema>;

{"items":[{"sku":"A1","discount":0.1},{"sku":"A2","discount":null}]}

import { z } from "zod";

export const ItemSchema = z.object({
  sku: z.string(),
  discount: z.number().nullable(),
});

export const RootSchema = z.object({
  items: z.array(ItemSchema),
});

export type Root = z.infer<typeof RootSchema>;

Cómo convertir JSON a Zod

1. 1

   Pega tu JSON

   Suelta un objeto JSON, un array o una respuesta de API en el campo de entrada. La conversión empieza al instante.

2. 2

   Ajusta la salida

   Renombra el esquema raíz y activa o no la línea import, el tipo z.infer o la palabra clave export para adaptarlo al estilo de tu proyecto.

3. 3

   Copia o descarga

   Toma el esquema Zod generado con un clic y pégalo directamente en tu capa de validación.

Common Use Cases

Validar respuestas de API

Convierte una respuesta de ejemplo REST o GraphQL en un esquema Zod y analízala en la frontera del fetch, para que los datos mal formados fallen rápido con un error claro en lugar de filtrarse por tu aplicación.

Formularios y entradas con tipos

Genera un esquema para la entrada de un formulario o una consulta y reutiliza el tipo z.infer en tu interfaz y tus manejadores para una seguridad de tipos de extremo a extremo.

Esquemas de tRPC y herramientas de IA

Arranca los esquemas de entrada y salida de procedimientos tRPC o herramientas de IA con salida estructurada a partir de un payload de ejemplo en vez de escribirlos a mano.

Cómo funciona la conversión

Inferencia estructural

Cada objeto se convierte en un esquema con nombre; las formas idénticas se declaran una sola vez y se reutilizan. Los arrays de objetos se fusionan clave a clave, y las claves ausentes en algunos elementos se convierten en .optional().

Correspondencia de tipos correcta

Los enteros se asignan a z.number().int() y los decimales a z.number(). Las cadenas, los booleanos y los null se asignan a z.string(), z.boolean() y z.null(); un array de primitivos mezclados se convierte en un z.union().

Tipos de TypeScript incluidos

Se emite un alias de tipo z.infer para el esquema raíz, así el esquema sigue siendo la única fuente de verdad y tus tipos nunca se desincronizan de tu validación.

100% del lado del cliente

El análisis y la generación se ejecutan en tu navegador sin llamadas de red, por lo que tus datos siguen siendo privados.

Consejos para esquemas Zod limpios

Nombra tu esquema raíz

Define un nombre raíz significativo como User o ApiResponse en lugar del Root predeterminado para un código legible y autodocumentado.

Afina z.unknown() y las uniones

Los arrays vacíos o mixtos producen z.unknown() o un z.union() amplio. Pega una muestra más rica y representativa para que la herramienta infiera tipos precisos, luego ajusta todo lo que siga siendo ambiguo.

Valida en la frontera

Llama a safeParse() donde entran datos no confiables — respuestas de API, entrada de formularios, webhooks — para que los datos incorrectos se detecten antes de llegar a la lógica de tu aplicación.

Preguntas frecuentes