Validador de JSON Schema

Cole um JSON Schema de um lado e um documento JSON do outro para verificar os dados contra o schema. Cada falha lista o caminho exato dentro do documento e a regra que foi violada, seja um campo obrigatório ausente, um tipo errado ou um formato inválido como um endereço de e-mail.

O que exatamente a ferramenta checa, e como os erros aparecem?

A validação checa o documento contra todas as regras do schema de uma vez, em vez de parar no primeiro erro, então você recebe a lista completa de problemas em uma única passada. Cada item mostra o caminho até o campo usando um JSON Pointer, algo como /users/0/email, a palavra-chave que falhou (required, type, format e por aí vai), e a mensagem do Ajv explicando o que deu errado. Quando possível, a ferramenta também aponta a linha correspondente no JSON colado, para você ir direto ao valor problemático em vez de contar chaves e colchetes. As checagens de formato, como confirmar se uma string é um e-mail, uma data ou uma URL válidos, usam o pacote ajv-formats.

Antes de validar, tanto o schema quanto o documento são interpretados como JSON, e qualquer erro de sintaxe aparece com a própria linha em vez de uma mensagem genérica. Se o schema em si estiver malformado a ponto de o Ajv não conseguir compilá-lo, por exemplo referenciando uma palavra-chave não suportada, isso também aparece como um erro de compilação separado.

Quais drafts de JSON Schema a ferramenta suporta?

A ferramenta lê o campo $schema e troca de validador conforme o caso: schemas que declaram a Draft 2020-12 são compilados com a build 2020 do Ajv, e qualquer outro, incluindo o estilo mais antigo da Draft-07, cai no Ajv padrão. Na prática, você pode colar qualquer um dos dois estilos sem precisar escolher um modo manualmente. Veja o json-schema.org para a especificação completa e as diferenças entre as drafts.

Meu schema ou os meus dados são enviados para algum lugar?

Não. A validação roda inteiramente no navegador usando o Ajv, um validador de JSON Schema bastante usado, e nem o schema nem o documento colado são transmitidos para lugar nenhum. Isso importa quando você está checando arquivos de configuração, payloads de API ou fixtures de teste que contêm dados reais de usuários, credenciais ou outros campos sensíveis.

Use esta ferramenta ao escrever um schema para um contrato de API, investigar por que um payload falha na validação no CI, ou revisar um arquivo de configuração antes de fazer deploy.