Pontos-chave
- 01Alimentado por Ajv, o validador de JSON Schema JavaScript mais amplamente utilizado — o que passa aqui passa no Node.js, Fastify e na maioria das cadeias de ferramentas JS.
- 02Relata cada erro de validação de uma vez (modo allErrors), não apenas a primeira falha.
- 03Cada erro inclui o caminho JSON Pointer para o campo que falha, facilitando a navegação rápida.
- 04Tanto o schema quanto os dados são executados inteiramente no seu navegador — nada é enviado.
Por Que Validar JSON Contra um Schema?
JSON Schema é a forma padrão de descrever a estrutura de um documento JSON — campos obrigatórios, tipos permitidos, restrições de valor, estruturas de objetos aninhados. Validar contra um schema antes de um payload chegar à produção detecta incompatibilidades de tipo, campos obrigatórios ausentes e violações de restrição cedo, quando são baratos de corrigir.
Os casos de uso mais comuns são testar corpos de requisição e resposta de API, validar arquivos de configuração, verificar objetos de exemplo do OpenAPI e verificar exportações de dados contra uma estrutura conhecida. O validador do Handytool usa Ajv — a biblioteca de JSON Schema JavaScript de facto, usada dentro do próprio Node.js — então os resultados aqui correspondem ao que seu backend verá.
Como Validar JSON Contra um Schema
- 01
Cole seu JSON Schema
Cole o schema no painel esquerdo. Pode ser um schema Draft 7, 2019-09 ou 2020-12 com type, properties, required, items, anyOf, allOf — qualquer palavra-chave padrão suportada por Ajv.
- 02
Cole seus dados JSON
Cole o documento de dados que você deseja validar no painel direito. Esta é a instância — um corpo de requisição de API, um objeto de configuração, um registro de exportação ou um único exemplo do seu spec OpenAPI.
- 03
Clique em Validar
Ajv executa a validação com allErrors: true, o que significa que coleta cada falha em vez de parar na primeira.
- 04
Revise a lista de erros
Cada erro mostra o caminho JSON Pointer para o valor que falhou (por exemplo, /user/email), a palavra-chave que falhou (type, required, minimum) e uma mensagem legível. Corrija cada um e revalide.
O Que Desenvolvedores Validam Com JSON Schema
- 01Corpos de requisição de API REST — confirme que um payload corresponde à forma esperada do endpoint antes de enviar.
- 02Objetos de exemplo de spec OpenAPI — valide cada exemplo contra o componente de schema inline.
- 03Arquivos de configuração — garanta que as chaves obrigatórias estejam presentes e os valores sejam do tipo correto.
- 04Registros de pipeline de dados — detecte desvio estrutural entre produtores e consumidores de dados.
- 05Payloads de envio de formulário — teste se a validação de frontend espelha as restrições de schema de backend.
- 06Corpos de webhook de terceiros — confirme que o schema documentado corresponde ao payload real.
Validação Privada, Sem Servidor Necessário
Ajv é executado inteiramente no seu navegador. Nem o schema nem os dados são enviados para nenhum servidor — você pode validar com segurança schemas que descrevem estruturas de dados internas e objetos de dados que contêm valores de campo sensíveis.
O validador suporta rascunhos de JSON Schema 6, 7, 2019-09 e 2020-12. O rascunho mais comum em uso é o Draft 7, que cobre todas as palavras-chave cotidianas: type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not e $ref.
Perguntas Frequentes do Validador de JSON Schema
Quais rascunhos de JSON Schema são suportados?
Ajv suporta rascunhos 6, 7, 2019-09 e 2020-12. O Draft 7 é o mais comum em bases de código existentes e cobre todas as palavras-chave padrão.
Por que meu schema $ref não resolve?
URLs de $ref externas não são buscadas nesta ferramenta somente de navegador. Incorpore todos os schemas referenciados usando $defs e ponteiros JSON locais como #/$defs/MyType.
Meu schema ou dados são enviados para algum servidor?
Não. Ajv é executado inteiramente no seu navegador — tanto o schema quanto os dados permanecem no seu dispositivo.
Posso usar isso para validar um spec OpenAPI 3?
Você pode validar componentes de schema individuais e objetos de exemplo. Validar o documento OpenAPI inteiro requer um validador OpenAPI dedicado que entenda o meta-schema da spec.
Por que vejo vários erros em vez de apenas o primeiro?
O validador é configurado com allErrors: true, o que faz Ajv coletar cada falha em vez de parar na primeira. Isso é intencional — você pode corrigir todos os problemas em uma única passagem em vez de fazer tentativas de validação repetidas.