JSON Schema Validator – Valide um JSON contra o schema
Cole o JSON e o JSON Schema e veja cada erro de validação com o caminho do campo. Confira contratos de API antes de subir a integração.
Palavras-chave suportadas
type, enum, const, required, properties, patternProperties, additionalProperties, items (inclusive tupla), minItems, maxItems, uniqueItems, minLength, maxLength, pattern, format (email, uri, uuid, date, date-time, ipv4, hostname), minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf, minProperties, maxProperties, allOf, anyOf, oneOf, not e $ref local (#/definitions/... e #/$defs/...).
Como usar esta ferramenta
- Cole o JSON Schema no primeiro campo
- Cole o JSON a validar no segundo
- Leia a lista de erros com o caminho de cada campo
- Corrija e valide de novo até ficar limpo
Sobre esta ferramenta
O que é
JSON Schema é um vocabulário para descrever a estrutura de um JSON: tipos, campos obrigatórios, formatos, limites e valores permitidos. É a base da validação de contratos em OpenAPI.
Quando usar
- Conferir se o payload atende ao contrato antes de integrar
- Validar arquivos de configuração contra um schema publicado
- Depurar erro 422 de uma API que valida por schema
- Testar um schema novo com exemplos reais
- Documentar para o time por que um payload foi rejeitado
Perguntas frequentes
- O que significa o erro required?
- Que um campo declarado como obrigatório no schema não está presente no JSON. O caminho mostrado indica em qual objeto a ausência foi detectada.
- Qual a diferença entre JSON Schema e validação de sintaxe?
- A validação de sintaxe só diz se o JSON está bem formado. O JSON Schema vai além e verifica se os campos, tipos, formatos e limites correspondem ao contrato esperado.
- additionalProperties false rejeita o quê?
- Qualquer campo que não esteja declarado em properties. É útil para pegar erro de digitação em nome de campo, que de outro modo passaria despercebido.