Conversor JSON para schema Zod

O que é um schema Zod?

Exemplos

{"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>;

Como converter JSON para Zod

1. 1

   Cole seu JSON

   Insira um objeto JSON, array ou resposta de API no campo de entrada. A conversão começa instantaneamente.

2. 2

   Ajuste a saída

   Renomeie o schema raiz e alterne a linha de import, o tipo z.infer ou a palavra-chave export para combinar com o estilo do seu projeto.

3. 3

   Copie ou baixe

   Pegue o schema Zod gerado com um clique e cole-o direto na sua camada de validação.

Common Use Cases

Validar respostas de API

Transforme uma resposta de exemplo de REST ou GraphQL em um schema Zod e faça o parse na fronteira do fetch, para que dados malformados falhem rápido com um erro claro em vez de vazar pelo seu app.

Formulários e entradas com tipo seguro

Gere um schema para entrada de formulários ou queries e reutilize o tipo z.infer na sua UI e nos handlers para segurança de tipos de ponta a ponta.

Schemas de tRPC e de ferramentas de IA

Crie schemas de entrada e saída para procedimentos tRPC ou ferramentas de IA com saída estruturada a partir de um payload de exemplo, em vez de escrevê-los à mão.

Como a conversão funciona

Inferência estrutural

Cada objeto torna-se um schema nomeado; formatos idênticos são declarados uma vez e reutilizados. Arrays de objetos são mesclados chave por chave, e chaves ausentes em alguns itens tornam-se .optional().

Mapeamento de tipo correto

Inteiros mapeiam para z.number().int() e decimais para z.number(). Strings, booleanos e valores null mapeiam para z.string(), z.boolean() e z.null(); um array de primitivos mistos torna-se um z.union().

Tipos TypeScript incluídos

Um alias de tipo z.infer é emitido para o schema raiz, então o schema continua sendo a única fonte de verdade e seus tipos nunca se desalinham da sua validação.

100% no lado do cliente

O parsing e a geração rodam no seu navegador sem chamadas de rede, então seus dados permanecem privados.

Dicas para schemas Zod limpos

Nomeie seu schema raiz

Defina um nome de raiz significativo, como User ou ApiResponse, em vez do padrão Root, para um código legível e autodocumentado.

Refine z.unknown() e unions

Arrays vazios ou mistos produzem z.unknown() ou um z.union() amplo. Cole uma amostra mais rica e representativa para que a ferramenta infira tipos precisos, e depois aperte tudo o que permanecer ambíguo.

Valide na fronteira

Chame safeParse() onde dados não confiáveis entram — respostas de API, entrada de formulários, webhooks — para que dados ruins sejam capturados antes de chegarem à sua lógica de aplicação.

Perguntas frequentes