data

Gerador de JSON Schema

Gere JSON Schema a partir de JSON de exemplo e valide dados localmente com Draft 2020-12 ou Draft 7.

Pronto

Pronto para gerar um schema.

Curso de JSON Schema

Aprenda como JSON Schema descreve contratos de dados, valida payloads e evolui com APIs e arquivos de configuração.

Página do curso

Sobre esta ferramenta

O Gerador de JSON Schema do DevCove transforma um JSON de exemplo em um ponto de partida prático para schema e valida outro documento JSON no mesmo workspace. Use para respostas de API, mocks, fixtures, arquivos de configuração e rascunhos de documentação. A geração e a validação rodam localmente no navegador.

Como usar

Use esta ferramenta quando você tem um exemplo real de JSON e precisa de um schema para validação de API, mocks ou documentação.

  1. Cole um objeto ou array JSON representativo em JSON de exemplo, ou use o exemplo de resposta de API já carregado.
  2. Escolha Draft 2020-12 para projetos novos, ou Draft 7 quando um validador ou plataforma existente ainda exigir a versão antiga.
  3. Use obrigatórios em modo Estrito quando o exemplo deve definir propriedades obrigatórias. Use Flexível para um ponto de partida mais permissivo.
  4. Mantenha Inferir formatos ativo para detectar strings comuns como email, URI, UUID, date e date-time.
  5. Clique em Gerar schema e revise o JSON Schema gerado antes de tratá-lo como contrato.
  6. Cole outro documento JSON em JSON para validação e clique em Validar dados para conferir contra o schema gerado.
  7. Copie ou baixe o schema quando ele estiver alinhado ao seu uso em API, fixture ou documentação.

Recursos

Criado como um workspace de schema independente, separado do Formatador JSON, para equipes que precisam de um contrato de validação reutilizável:

  • Gera JSON Schema a partir de objetos, arrays, objetos aninhados, arrays de objetos, primitivos e valores null.
  • Usa JSON Schema Draft 2020-12 por padrão, com Draft 7 disponível para validadores antigos.
  • Modos Estrito e Flexível para controlar como o exemplo define campos obrigatórios.
  • Mescla itens de arrays para que campos opcionais em linhas de exemplo não sejam marcados como obrigatórios se nem todas as linhas os incluem.
  • Inferência de campos anuláveis quando exemplos misturam null e valores concretos.
  • Inferência opcional de formatos para email, URI, UUID, date e date-time.
  • Validação local com Ajv contra o schema gerado ou colado.
  • Erros de validação legíveis com caminhos, palavras-chave e parâmetros.
  • Ações para copiar e baixar arquivos de schema gerados.
  • Processamento 100% no navegador: exemplos, schemas e dados de validação não são enviados.

FAQ

O que é JSON Schema?

JSON Schema é um vocabulário para descrever a estrutura de dados JSON: propriedades de objetos, campos obrigatórios, tipos, arrays, formatos e restrições. Desenvolvedores usam em validação de API, documentação, mocks e testes.

O que significa Draft 2020-12?

É uma versão da especificação JSON Schema. Draft 2020-12 é uma boa escolha moderna para trabalhos novos, enquanto Draft 7 ainda aparece em ferramentas e plataformas antigas. Este gerador permite escolher qualquer uma das duas.

O schema gerado é definitivo?

Trate como um bom ponto de partida, não como contrato automático. Revise campos obrigatórios, adicione regras de negócio como tamanhos mínimos ou enumerações, e ajuste o que o exemplo não consegue provar.

Como funciona o modo obrigatório Estrito?

O modo Estrito marca propriedades como obrigatórias quando aparecem em todos os objetos de exemplo naquele nível. Em arrays de objetos, se uma linha não tiver a propriedade, ela não vira obrigatória.

Quando devo usar o modo Flexível?

Use Flexível quando o exemplo é incompleto, quando campos de API costumam ser opcionais, ou quando você quer um schema permissivo antes de apertar as regras manualmente.

A ferramenta valida formatos como email ou URI?

Sim. Com inferência de formatos ativa, a ferramenta pode adicionar e validar formatos comuns como email, URI, UUID, date e date-time.

Meu JSON é enviado?

Não. A geração e a validação rodam no navegador usando JavaScript local e Ajv. O DevCove não envia nem armazena seu exemplo, schema ou dados de validação.