Validador de JSON Schema

Palavras-chave suportadas

Núcleo: type, enum, const, multipleOf, maximum, minimum, exclusiveMaximum, exclusiveMinimum, maxLength, minLength, pattern, maxItems, minItems, uniqueItems, maxContains, minContains, maxProperties, minProperties, required, dependentRequired.

Composição: allOf, anyOf, oneOf, not.

Aplicadores: properties, patternProperties, additionalProperties, items, prefixItems, contains, propertyNames.

Condicionais: if, then, else, dependentSchemas.

Referências: $ref, $defs, $id, $anchor.

Formatos (com validação quando habilitada): date-time, date, time, duration, email, hostname, ipv4, ipv6, uri, uuid, regex.

Saída de erro

FAIL  /user/email        format            "not-an-email" não é um "email" válido
FAIL  /user/age          minimum           -3 é menor que o mínimo 0
FAIL  /orders/0/total    type              "42" não é do tipo "number"
FAIL  /                  required          propriedade obrigatória "shippingAddress" ausente

Cada erro inclui o caminho e a palavra-chave que falhou, facilitando a localização no seu editor.

Diferenças de rascunho que pegam

Defina o rascunho correto; validar um esquema rascunho-04 como 2020-12 irá interpretar incorretamente id e algumas outras sutilezas.

Fluxos de trabalho típicos

• Teste de contrato de API: antes de um deploy, execute o esquema OpenAPI gerado/atualizado contra respostas de amostra reais.
• Fortalecimento de configuração: valide cada configuração YAML/JSON no CI contra um esquema antes de mesclar.
• Ingestão de dados: rejeite cargas úteis que não correspondem à forma esperada cedo, com uma mensagem de erro clara.

Erros comuns

• Esquecer a aplicação de format. Por padrão, a maioria dos validadores trata formatos desconhecidos apenas como anotações. Habilite a validação de formato estrito para realmente rejeitar emails e datas ruins.
• Uso excessivo de oneOf. Se dois ramos de oneOf se sobrepuserem, o documento falhará (deve corresponder exatamente a um). Use anyOf ou padrões de discriminador.
• Esquemas rígidos com additionalProperties: false. Adicionar um novo campo opcional se torna uma mudança quebradora. Omitir a menos que você realmente queira um objeto fechado.