Validador JSON Schema

Valide dados JSON contra um JSON Schema. Obtenha mensagens de erro detalhadas com caminhos exatos.

1
2
3
JSON Data
JSON Schema

Boas Práticas de JSON Schema

Escreva schemas melhores e capture mais erros de validação.

1

Comece com Campos Obrigatórios

Defina o array required primeiro, depois adicione restrições de tipo para cada propriedade.

2

Use Mensagens Descritivas

Adicione description a cada propriedade. Ajuda a entender o dado esperado quando a validação falha.

3

Aproveite Composição de Schema

Use allOf, anyOf e oneOf para compor schemas complexos. Use $ref para definições compartilhadas.

4

Valide em Pipelines CI/CD

Use validação de schema no pipeline de build para capturar configurações inválidas antes do deploy.

Recursos de Validação de Schema

Ferramentas abrangentes de validação JSON Schema.

Suporte a Drafts

Suporta JSON Schema Draft 4, 6, 7, 2019-09 e 2020-12.

Relatórios de Erro Detalhados

Mensagens de erro precisas com caminhos JSON apontando exatamente onde a validação falhou.

Visão Lado a Lado

Veja dados JSON e schema lado a lado para referência cruzada fácil.

O que é JSON Schema?

JSON Schema é um vocabulário que permite validar a estrutura e o conteúdo de dados JSON. Descreve a forma esperada, os tipos e as restrições de um documento JSON — similar a como um schema de banco de dados define a estrutura de uma tabela.

Exemplo básico

Um schema que exige um campo "name" (string) e "age" (number):

JSON Schema
{
  "type": "object",
  "required": ["name", "age"],
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number", "minimum": 0 }
  }
}

Dados válidos

{ "name": "Alice", "age": 30 }

Dados inválidos

{ "name": 123, "age": -5 }

Palavras-chave comuns

type

Define o tipo esperado: string, number, object, array, boolean, null

required

Lista as propriedades que devem estar presentes em um objeto

properties

Define schemas para cada propriedade de um objeto

items

Schema para itens do array — valida cada elemento

enum

Restringe o valor a uma lista fixa de valores permitidos

pattern

Valida uma string contra um padrão de expressão regular

FAQ do Validador JSON Schema

O que é JSON Schema?

JSON Schema é um vocabulário para anotar e validar documentos JSON. Define estrutura, tipos e restrições.

Quais drafts são suportados?

Draft 4, 6, 7, 2019-09 e 2020-12. A versão é auto-detectada pela palavra-chave $schema.

Pode validar objetos aninhados?

Sim, suporta totalmente schemas aninhados incluindo referências $ref e combinadores allOf/anyOf/oneOf.

Como especifico campos obrigatórios?

Adicione array required no mesmo nível de properties com os nomes dos campos obrigatórios.

Qual a diferença entre anyOf, oneOf e allOf?

allOf: deve corresponder a todos. anyOf: pelo menos um. oneOf: exatamente um.

Verifica erros no próprio schema?

Sim, o schema deve ser JSON válido e seguir a sintaxe JSON Schema.

Posso usar $ref para definições compartilhadas?

Sim, referências $ref internas são totalmente suportadas. Defina sub-schemas em definitions ou $defs.

Ferramentas Relacionadas

Explore mais ferramentas JSON para otimizar seu fluxo de trabalho.