Entendendo o JSON Schema: Guia Completo de Validação

# Entendendo o JSON Schema: Guia Completo de Validação

O JSON Schema é uma linguagem poderosa para descrever e validar o formato dos seus documentos JSON. Ele funciona como um "contrato" que garante que os dados enviados ou recebidos pela sua API estão no formato correto.

Por que usar JSON Schema?

• Validação Automática: Garante que campos obrigatórios existam.
• Tipagem: Impede que uma idade seja enviada como texto em vez de número.
• Documentação: Serve como uma fonte única de verdade sobre a estrutura dos dados.

---

Exemplo Básico de Schema

Aqui está um schema que valida um perfil de usuário:

{
  "type": "object",
  "properties": {
    "nome": { "type": "string" },
    "idade": { "type": "integer", "minimum": 18 },
    "email": { "type": "string", "format": "email" }
  },
  "required": ["nome", "email"]
}

Implementação em JavaScript (Ajv)

O Ajv é o validador mais rápido para o ecossistema Node.js:

import Ajv from 'ajv';
const ajv = new Ajv();

const validate = ajv.compile(meuSchema);
const valido = validate(meusDados);

if (!valido) console.log(validate.errors);

---

Ferramentas Úteis

JSONSchema.net: Gera schemas automaticamente a partir de um exemplo de JSON.

Big JSON Viewer: Ajuda a visualizar estruturas complexas antes de você criar o contrato de validação.

Conclusão

Implementar JSON Schema nas suas APIs é o primeiro passo para criar sistemas resilientes. Ele reduz bugs causados por dados inesperados e facilita a comunicação entre as equipes de Back-end e Front-end.