Gerador de JSON Schema
Gere JSON Schema automaticamente a partir de dados JSON
Inferido a partir dos dados de exemplo. Os schemas dos itens de array usam o primeiro item; revise e ajuste o schema antes de validar.
Processado neste dispositivo. Seu texto não é enviado.
Gerador de JSON Schema online e gratuito
O nosso gerador de JSON Schema analisa dados JSON de exemplo e produz na hora uma definição de JSON Schema válida, com detecção precisa de tipos, tratamento de objetos aninhados e inferência dos itens de arrays. Basta colar um objeto JSON, escolher a versão do draft e obter um schema para usar em validação de APIs, geração de formulários ou documentação, sem escrever uma única linha de schema à mão.
A ferramenta oferece suporte aos drafts 04, 06 e 07 do JSON Schema, as versões mais adotadas no ecossistema. Ela percorre recursivamente a sua estrutura JSON, detectando strings, números, inteiros, booleanos, nulos, objetos e arrays. Nos arrays, o schema é inferido a partir do primeiro elemento, o que garante definições de itens precisas mesmo em estruturas aninhadas complexas.
As opções configuráveis permitem ativar os arrays de propriedades obrigatórias, adicionar marcadores de descrição para documentação e impor additionalProperties: false para uma validação rigorosa. Quando o resultado estiver bom, baixe-o como arquivo .schema.json ou copie-o para a área de transferência com um clique. Tudo roda localmente no seu navegador: seus dados nunca são enviados a um servidor.
Principais recursos
- Suporte aos drafts 04, 06 e 07 do JSON Schema, com o URI $schema correto
- Detecção automática de tipos: string, number, integer, boolean, null, object e array
- Geração recursiva de schemas para objetos e arrays com vários níveis de aninhamento
- Inferência do tipo dos itens de array com base no primeiro elemento
- Arrays "required" configuráveis para controlar o rigor da validação
- Geração opcional de marcadores "description" para schemas autodocumentados
- Opção para "additionalProperties: false", que impõe formatos de objeto rigorosos
- Baixe o schema gerado como arquivo .schema.json
- Cópia para a área de transferência com um clique
- JSON de exemplo pré-carregado para experimentar rapidamente
Como usar o Gerador de JSON Schema
- Configure as opções do schema: selecione a versão do draft e ative ou desative os arrays required, as descrições e o additionalProperties conforme a sua necessidade.
- Cole seu JSON: digite ou cole um objeto JSON de exemplo no painel de entrada. Você também pode clicar em "JSON de exemplo" para carregar um exemplo.
- Gere o schema: clique em "Gerar schema" para produzir o JSON Schema no painel da direita.
- Revise e ajuste: confira o resultado. Altere opções como campos obrigatórios ou descrições e gere novamente, se necessário.
- Exporte o schema: clique em "Copiar" para colocar o schema na área de transferência ou em "Baixar .schema.json" para salvá-lo como arquivo.
Casos de uso
- Especificações OpenAPI / Swagger: gere definições de schema para os corpos de requisição e resposta na documentação da sua API.
- Validação de requisições no backend: crie schemas para validar payloads JSON recebidos em Express, FastAPI, Spring Boot ou outros frameworks.
- Geração de formulários no frontend: use schemas em bibliotecas como react-jsonschema-form para gerar automaticamente formulários de interface a partir de modelos de dados.
- Contratos de dados: defina e compartilhe contratos de dados estruturados entre microsserviços ou entre as equipes de frontend e backend.
- Validação de configuração: valide arquivos de configuração JSON em pipelines de CI/CD para detectar erros estruturais antes da implantação.
- Planejamento de migração de banco de dados: documente os formatos de dados esperados ao projetar novas tabelas ou coleções.
- Autocompletar na IDE: faça referência a um JSON Schema nas configurações do VS Code para habilitar o IntelliSense e a validação em arquivos JSON personalizados.
Perguntas frequentes
Esta ferramenta é gratuita?
Sim, o gerador de JSON Schema é totalmente gratuito, sem cadastro nem limites de uso. Gere schemas para quantos objetos JSON quiser, sem nenhum custo.
Meus dados estão seguros?
Sim. Toda a geração de schemas acontece no seu navegador. Seus dados JSON nunca são enviados a nenhum servidor, o que torna seguro usar a ferramenta com payloads de APIs proprietárias ou estruturas de dados internas.
O que é JSON Schema?
O JSON Schema é um vocabulário declarativo para anotar e validar documentos JSON. Ele descreve a estrutura esperada, os tipos de dados, as propriedades obrigatórias e as restrições de um objeto JSON. É muito usado em especificações de API (OpenAPI/Swagger), bibliotecas de geração de formulários e ferramentas de validação de configuração.
Qual versão do draft devo usar?
O draft-07 é recomendado para a maioria dos projetos, por ser a versão com maior suporte entre bibliotecas de validação e ferramentas. Use o draft-04 ou o draft-06 apenas se a sua cadeia de ferramentas exigir especificamente uma versão mais antiga.
Posso editar o schema gerado?
O schema gerado é um ponto de partida. Depois de baixá-lo ou copiá-lo, você pode adicionar manualmente restrições como minLength, maximum, valores de enum ou regex de pattern, que não podem ser inferidas apenas dos dados de exemplo.
Ele trata arrays com tipos mistos?
O gerador infere os tipos dos itens do array a partir do primeiro elemento. Se o seu array tiver tipos mistos, talvez seja necessário ajustar manualmente a definição de items para um schema oneOf ou anyOf depois da geração.
Dicas e boas práticas
- Forneça dados de exemplo representativos: inclua todos os campos possíveis no seu JSON de exemplo para que o schema capture a estrutura completa.
- Ative os arrays required: ligue a opção "required" para impor campos obrigatórios ao usar o schema para validação.
- Adicione as descrições depois: ative os marcadores de descrição durante a geração e depois substitua-os por uma documentação significativa antes de compartilhar o schema.
- Use additionalProperties: false em APIs rigorosas: isso impede que os clientes enviem campos inesperados que poderiam causar problemas adiante.
- Valide após a geração: teste o seu schema com vários payloads de exemplo usando um validador de JSON Schema, para garantir que ele cobre os casos extremos.
- Versione seus schemas: guarde os arquivos de schema no controle de versão junto com o código da sua API para acompanhar as mudanças ao longo do tempo.