Gerador de JSON Schema
Gerador de JSON Schema online grátis. Cole um JSON de exemplo e infira instantaneamente um esquema draft-07 ou 2020-12 com propriedades obrigatórias, estratégias de arrays e detecção de formatos de string, tudo no navegador.
O que o gerador de JSON Schema faz?
Ele analisa um documento JSON de exemplo e infere o esquema que o descreve: o tipo de cada valor, as propriedades dos objetos aninhados e o esquema dos itens de arrays. O resultado é um JSON Schema draft-07 ou 2020-12 pronto para uso, que você pode copiar ou baixar.
Como funciona a inferência do esquema?
O gerador percorre seu valor de exemplo recursivamente: strings viram propriedades string (opcionalmente com um formato detectado como date ou email), inteiros viram integer, decimais viram number, booleanos viram boolean, null vira null, arrays viram array com um esquema de itens escolhido pela estratégia, e objetos viram object com um mapa de propriedades.
O que faz a opção de obrigatórias?
Quando ativada, toda propriedade encontrada em um objeto é tratada como mandatória: o gerador as reúne em um array required adequado em cada objeto, conforme a especificação JSON Schema. Desative se alguns campos podem faltar nos dados reais.
Qual estratégia de array escolher?
Mesclar todos os itens cria um esquema que cobre cada elemento (ex.: integer e number se mesclam em number). Somente o primeiro item usa o esquema do elemento zero. Uniforme exige que todos os elementos compartilhem o mesmo esquema e avisa caso contrário. Tupla mantém um esquema por posição, ideal para arrays de tamanho fixo.
Pode adicionar o cabeçalho de versão $schema?
Sim. O menu de versão $schema pode antepor o URI oficial do draft-07, o do 2020-12 ou não adicionar nada. O cabeçalho diz aos validadores qual especificação seu esquema segue.
O que é a detecção de formatos de string?
Quando ativada, valores string que parecem e-mails, datas, hostnames e similares recebem uma anotação format (ex.: format: email). Isso torna os esquemas mais precisos, mas às vezes anota demais textos curtos — dá para desligar para tipos string puros.
O esquema gerado é garantidamente perfeito?
Nenhuma inferência a partir de uma única amostra pode ser. O esquema reflete exatamente o seu exemplo: campos opcionais ausentes não aparecem e casos extremos podem exigir ajuste manual. Trate o resultado como um ótimo ponto de partida e ajuste limites, padrões e enums ao seu contrato real.
Meus dados são enviados para algum lugar?
Não. O esquema é inferido inteiramente no seu navegador; nada é enviado a servidores. Você também pode carregar o exemplo de um arquivo local, e a última entrada fica apenas no armazenamento local deste navegador.
Como usar Gerador de JSON Schema
Esta ferramenta infere um JSON Schema a partir de um documento JSON de exemplo. Cole ou carregue dados de amostra à esquerda, ajuste as opções, e o esquema draft-07 ou 2020-12 gerado aparece à direita em tempo real. Ele usa o motor de inferência to-json-schema localmente no seu navegador, com uma etapa de pós-processamento que converte os marcadores de requerido por propriedade do motor em arrays required conformes à especificação sobre seus objetos pais. Nada é enviado a lugar algum.
- Cole seu JSON de exemplo na área de texto à esquerda, ou use Carregar arquivo / Exemplo.
- Decida se toda propriedade deve ser obrigatória: marque Marcar todas as propriedades como requeridas para obter arrays required em cada objeto.
- Escolha uma estratégia de array: Mesclar todos os itens (um esquema cobrindo cada elemento), Apenas o primeiro item, Itens uniformes (erro em caso de divergência) ou Tupla (um esquema por posição).
- Escolha a versão do $schema: nenhuma, Draft-07 ou Draft 2020-12, para adicionar a URI oficial de cabeçalho.
- Ative Detectar formatos de string para anexar anotações de formato como email ou date a valores que se pareçam com eles.
- Copie o resultado ou baixe-o como schema.json; o esquema gerado é reformatado com indentação de 2 espaços para legibilidade.
A inferência reflete exatamente a amostra que você fornece — um campo ausente da amostra não aparecerá no esquema, então alimente-o com seu exemplo mais rico e realista. Valores como Ada Lovelace podem ser anotados como format: color porque cadeias alfabéticas curtas lembram nomes de cores CSS; desative Detectar formatos de string para tipos de string simples, ou limpe a linha do formato à mão.
Ferramentas relacionadas
- Validador JSON Valide a sintaxe JSON instantaneamente com mensagens de erro detalhadas e números de linha. Ferramenta gratuita que funciona no seu navegador.
- Embelezar JSON Formate e embeleze JSON com recuo personalizável. Embeleze JSON comprimido instantaneamente no seu navegador.
- JSON para TypeScript Converta JSON em interfaces e definições de tipos TypeScript instantaneamente. Suporta objetos aninhados, arrays e tipos união.
- Calculadora Chmod Calculadora chmod online gratuita para visualizar e calcular permissões de arquivo Linux com caixas de seleção. Converta instantaneamente entre notação numérica (755, 644) e simbólica (rwxr-xr-x). Suporta permissões especiais como setuid, setgid, sticky bit.
- Tabela ASCII Referência completa de codificação de caracteres ASCII com códigos decimais, hexadecimais, octais, binários, entidades HTML e descrições. Pesquisa e filtro instantâneos.
- Testador de Requisições HTTP Teste APIs REST diretamente no seu navegador. Envie requisições GET, POST, PUT, DELETE com headers, body e parâmetros personalizados. Veja status, headers e corpo JSON instantaneamente.
- Gerador .htaccess Gere regras .htaccess do Apache para redirecionamentos, reescritas, cabeçalhos de segurança, cache e mais.
- Gerador de Robots.txt Gerador gratuito de robots.txt online. Crie e personalize arquivos robots.txt para controlar a rastreamento de motores de busca, gerenciar acesso de rastreadores e otimizar o SEO do seu site.