Validador de JSON Schema
Valide um documento JSON em relação a um JSON Schema e veja exatamente onde ele falha.
Exemplos de uso
Verificar o formato de uma resposta de API
Cole o schema prometido pela sua API e uma resposta de exemplo para confirmar que os campos, tipos e propriedades obrigatórias realmente correspondem antes de publicar.
Depurar um arquivo de configuração com falha
Quando uma ferramenta rejeita sua configuração com um erro vago, valide-a aqui contra o schema documentado para ver exatamente qual campo está errado e por quê.
Revisar o contrato de dados de um pull request
Antes de aprovar uma mudança em uma estrutura JSON compartilhada, cole o schema atualizado e alguns dados de exemplo para garantir que nada quebre silenciosamente.
Validar um arquivo de configuração contra um schema documentado
Muitas ferramentas de linha de comando publicam um JSON Schema para o seu arquivo de configuração — cole o seu junto com o schema publicado para detectar erros de digitação e incompatibilidades de tipo antes de executar a ferramenta.
Testar casos extremos de um schema que você está escrevendo
Ao rascunhar um novo schema, cole alguns documentos deliberadamente inválidos (sem um campo obrigatório, com tipo errado) para confirmar que o seu schema realmente os rejeita como esperado.
Perguntas frequentes
Qual draft do JSON Schema é suportado?
Esta ferramenta valida contra o JSON Schema Draft-07, o draft mais compatível e amplamente suportado. Palavras-chave introduzidas apenas em drafts posteriores, como 2019-09 ou 2020-12 (por exemplo '$recursiveRef' ou a nova forma de array 'prefixItems'), não são reconhecidas e podem ser ignoradas silenciosamente.
Meu schema ou dados são enviados para um servidor?
Não. Tanto o schema quanto o documento são validados inteiramente no seu navegador usando a biblioteca ajv. Nada é enviado para lugar nenhum.
Qual a diferença entre 'Schema inválido' e uma falha de validação?
'Schema inválido' significa que o próprio JSON Schema está malformado ou contraditório e não pôde ser compilado, então a validação nem chegou a rodar. Uma falha de validação significa que o schema compilou normalmente, mas seu documento não satisfaz as regras dele — cada regra violada é listada com o caminho exato nos seus dados.
Como interpreto um erro como 'em `/user/age`: must be >= 0'?
O caminho mostra onde está o problema no seu documento JSON, usando '/' para separar chaves aninhadas e índices de array. A mensagem após os dois-pontos explica qual regra do schema foi violada.
Um schema pode referenciar outro schema com $ref?
Somente dentro do mesmo documento colado, usando JSON Pointers locais do mesmo documento (como '#/definitions/address'). Referências a arquivos ou URLs externos não são resolvidas, já que nada é buscado na rede.
O que 'additionalProperties: false' realmente impõe?
Faz o schema rejeitar qualquer objeto que tenha propriedades não listadas explicitamente, o que é uma forma comum de detectar erros de digitação em nomes de campos (como 'eamil' em vez de 'email') que, de outra forma, passariam em silêncio.
Um schema vazio ({}) é válido?
Sim — um schema vazio não impõe nenhuma restrição, então todo documento JSON é validado com sucesso contra ele.