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.