gerar schema zod a partir de json
Cole o JSON e escolha Zod para obter o schema e o tipo inferido com z.infer. Formatos como e-mail, UUID e data e hora viram validadores específicos.
O tipo sai de z.infer.
UUID, e-mail e data e hora viram validadores próprios.
Falta em um documento e vem null em outro: nullish.
Os validadores passam a ser métodos de z.string().
Chaves numéricas viram z.record, não campos fixos.
O item vira ItemSchema e o array usa z.array.
Um campo é opcional quando falta em pelo menos um dos objetos observados naquela posição, seja em documentos diferentes ou em itens diferentes de um mesmo array. Se todos os objetos de um array de 50 itens têm a chave phone, ela é obrigatória; se um não tem, vira phone?: string. Já um valor null não torna o campo opcional: ele o torna anulável (string | null). Os dois conceitos são distintos na API e nas linguagens, por isso a ferramenta os separa. A opção Todos os campos opcionais marca cada campo como opcional, útil para PATCH e para respostas parciais.
.optional() aceita undefined, ou seja, chave ausente. .nullable() aceita null. .nullish() aceita os dois. No JSON, ausente e null são coisas diferentes, e a ferramenta usa cada método conforme o que as amostras mostram.
A saída padrão é para a versão 4. Escolha Zod 3 em Opções se o projeto ainda usa essa versão: os validadores de formato passam a ser métodos de z.string() e z.record recebe só o schema do valor.
Não por padrão: o z.object do Zod remove as chaves desconhecidas ao validar, em vez de falhar. Para recusá-las, use z.strictObject() na versão 4 ou .strict() na 3. O gerador não adiciona isso porque amostras raramente mostram todas as chaves que a API pode enviar.
Sim. Escolha TypeScript no lugar de Zod para ter apenas a interface. O Zod compensa quando o dado vem de fora, como respostas de API, formulários e arquivos.
export type Root = RootItem[];
export interface RootItem {
id: number;
number: string;
status: string;
createdAt: string;
total: number;
customer: Customer;
items: Item[];
tags: string[];
shipping: Shipping;
billing?: Shipping;
couponCode?: string;
}
export interface Customer {
id: string;
name: string;
email: string;
phone: string | null;
}
export interface Item {
sku: string;
name: string;
qty: number;
price: number;
}
export interface Shipping {
street: string;
city: string;
zip: string;
}
Texto com poucos valores repetidos, em pelo menos 8 amostras, vira enum.
Data e hora, data, UUID, e-mail, URL e IPv4.
Objetos com os mesmos campos viram um tipo só.
Chaves que parecem ids ou datas viram mapa, e objeto vazio vira mapa de valores desconhecidos.
Array de tamanho fixo com tipos diferentes por posição, como ["a", 1].
Evita int quando as amostras só trazem inteiros por acaso.
Recusa vírgula sobrando, comentários, aspas simples e afins.
Da linguagem: camelCase, snake_case ou PascalCase, com anotação da chave original. Dataclass e TypedDict sempre mantêm as chaves.
Go, C#, Java, Swift e Pydantic. Nas outras linguagens o campo continua texto.
readonly em TypeScript, frozen em Python, init em classes C# e let em Swift.
O JSON é processado no seu navegador. Nada do que você cola ou abre é enviado a servidores.