Ferramentas
PT

Gerador de JSON Schema

Cole um documento JSON de exemplo e receba um JSON Schema que o descreve – tipos, propriedades obrigatórias, objetos e arrays aninhados e formatos de string como email, date-time ou UUID.

JSON de exemplo

JSON Schema

Privado: seus dados são processados no próprio navegador e nunca são enviados a nenhum servidor.

Como gerar um JSON Schema

  1. Cole um exemplo de JSON representativo. Arrays com vários itens dão os melhores resultados, porque seus itens são mesclados em um único schema.
  2. Escolha a versão do schema (draft 2020-12 ou draft-07) e defina se as propriedades devem ser obrigatórias, se os formatos devem ser detectados e se propriedades extras devem ser proibidas.
  3. Copie ou baixe o schema e depois refine-o manualmente – por exemplo, adicionando descrições, enums ou valores mínimos e máximos.

O que o gerador deduz

Exemplo de JSONSchema
"ada@example.com"{"type": "string", "format": "email"}
"2026-05-01T10:00:00Z"formato date-time (também date, time, uri, uuid, ipv4)
42 / 4.5"integer" / "number"
uma chave presente em todos os objetoslistada em required
uma chave ausente em alguns itens do arrayopcional (fora de required)
[1, "a", null]"items": {"type": ["string", "integer", "null"]}
objetos misturados com valores simplesanyOf com um schema para cada tipo

O que é JSON Schema?

JSON Schema é um vocabulário para descrever e validar a estrutura de dados JSON: quais propriedades existem, qual é o tipo de cada uma, quais são obrigatórias e quais valores são permitidos. Ele é usado em contratos de API no OpenAPI, arquivos de configuração, geração de formulários e na validação da saída estruturada de modelos de IA. A versão atual é a 2020-12; a draft-07 ainda é suportada por muitas ferramentas mais antigas. A especificação é publicada em json-schema.org.

Como refinar o schema gerado

Perguntas frequentes

Qual versão do JSON Schema devo usar?

Use o draft 2020-12 em projetos novos – é a versão atual e a base do OpenAPI 3.1. Escolha o draft-07 se o seu validador ou suas ferramentas ainda não suportam a 2020-12.

Por que todas as minhas propriedades são obrigatórias?

Com um único objeto de exemplo, todas as propriedades estão presentes, então todas são marcadas como obrigatórias. Use um array com vários exemplos variados ou desative Marcar propriedades como obrigatórias.

O gerador consegue detectar enums ou intervalos?

Não. Um único exemplo não mostra quais valores são permitidos em geral, então enums, valores mínimos e máximos e padrões precisam ser adicionados manualmente.

Como validar um JSON com o schema?

Use uma biblioteca de validação como Ajv para JavaScript ou jsonschema para Python. Muitos editores de código também validam um arquivo JSON com base no schema indicado na propriedade $schema.