Como usar: JSON para JSON Schema
- Cole um exemplo de JSON — uma resposta de API, um arquivo de configuração, um registro de banco de dados — ou clique em Sample.
- Para melhores resultados, cole vários exemplos como um array JSON: campos ausentes em alguns deles se tornam opcionais, e tipos diferentes viram uma união.
- Escolha o draft, como o required será definido e se quer detectar formatos, criar enums, proibir propriedades extras ou manter os exemplos.
- Copie ou baixe o schema — ou envie-o direto para o conversor JSON Schema para TypeScript ou para o validador.
Como o schema é inferido
- Tipos: strings, números, inteiros (números inteiros), booleanos, null, objetos e arrays. Um campo que às vezes é número e às vezes null vira
"type": ["number", "null"]. - Arrays: cada item é unificado em um único schema
items, então um array de objetos de usuário gera um schema de usuário com todas as chaves encontradas. - Required: por padrão, uma chave só é obrigatória se aparecer em todos os objetos daquele formato. Com um único exemplo, todas as chaves são obrigatórias.
- Formatos: strings que parecem todas um email, URI, UUID, data, date-time, hora, IPv4 ou IPv6 recebem um
format. - Enums: um campo string com poucos valores que se repetem em muitos exemplos (como
status) vira umenum.
Um schema inferido descreve os seus exemplos, não a sua intenção — revise-o: restrinja strings com minLength ou pattern, adicione minimum/maximum a números e decida quais campos são realmente opcionais. Depois, verifique dados com o Validador de JSON Schema ou gere tipos com JSON Schema para TypeScript.
Também pesquisado como: gerador de json schema, gerar json schema a partir de json, inferir json schema, json schema a partir de exemplo, criar json schema online, json schema draft 2020-12, json para schema.
Ferramentas que combinam com: JSON para JSON Schema
- JSON para TypeScript — Cole um exemplo de JSON, como a resposta de uma API ou um arquivo de configuração, e receba interfaces TypeScript prontas para uso, com tipos aninhados, propriedades opcionais e union types.
- Formatação JSON — Cole o JSON aqui para formatá-lo, compactá-lo ou validá-lo.
- Validador OpenAPI / Swagger — Cole uma especificação de API para checar contra o schema oficial do OpenAPI, encontrar referências quebradas e parâmetros de path inconsistentes, e ver todos os endpoints de uma vez.
- Gerador de dados simulados — Crie até 10.000 linhas de dados de teste realistas — usuários, produtos, pedidos, endereços, empresas ou registros de API aninhados — ou crie seu próprio esquema.
Perguntas frequentes
Como gerar um JSON Schema a partir de JSON?
Cole o JSON aqui: o gerador percorre cada valor, escreve o tipo, as properties e os items correspondentes, marca as chaves como required e detecta formatos. Cole vários exemplos em um array para um resultado mais preciso.
Qual draft do JSON Schema devo usar?
O draft 2020-12 é a versão atual e a que o OpenAPI 3.1 usa. Escolha draft-07 para ferramentas e bibliotecas mais antigas que ainda não suportam o 2020-12.
Por que um campo não está marcado como required?
Ele estava ausente em pelo menos um dos seus exemplos. Mude “Campos obrigatórios” para “Todas as chaves” se todo campo precisar estar sempre presente.
Posso transformar o schema em tipos TypeScript?
Sim — clique em Para TypeScript para abrir o schema no conversor de JSON Schema para TypeScript.
Posso instalar o JSON para JSON Schema como um aplicativo da web e usá-lo offline?
Sim. O JSON para JSON Schema é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.