JSON para iniciantes: o que é, como ler e como validar

Se você já abriu o console de uma página web ou inspecionou uma resposta de API, provavelmente esbarrou em chaves, colchetes e aspas em um padrão estranho — isso é JSON. JavaScript Object Notation é o formato de dados mais usado na comunicação entre serviços web, presente em praticamente todas as APIs públicas, em arquivos de configuração e até em bancos de dados modernos.

A estrutura básica

JSON tem apenas dois tipos de estruturas: objetos (entre chaves) e listas (entre colchetes). Dentro deles, valores podem ser strings, números, booleanos (true/false), nulo (null), ou outros objetos/listas aninhados. Exemplo:

{ "nome": "Maria", "idade": 32, "ativo": true, "hobbies": ["leitura", "corrida"] }

Regras de sintaxe que confundem iniciantes

• Chaves de objeto SEMPRE entre aspas duplas — nunca aspas simples nem sem aspas;
• Strings também só com aspas duplas;
• Não pode ter vírgula sobrando depois do último item (trailing comma é erro);
• Não pode ter comentários — JSON puro não suporta // nem /* */;
• Números não levam aspas; se levam, viram string.

Por que JSON e não XML?

JSON ganhou a guerra contra XML por ser mais leve (sem tags abertura/fechamento duplicadas), mais legível e nativamente compatível com JavaScript. Uma resposta de API em JSON costuma ter 30 a 50% do tamanho do equivalente em XML, o que reduz banda e latência.

Lendo respostas de API

Quando você consome uma API REST, a resposta quase sempre vem em JSON. A primeira coisa a fazer é formatar com indentação — texto JSON minificado em uma linha só é praticamente ilegível. Use o formatador JSON do UtiliHub para colar a resposta e visualizar a estrutura indentada com destaque de sintaxe.

Validando JSON

Um caractere fora do lugar quebra o parsing inteiro. Os erros mais comuns são vírgula faltando, aspas não fechadas e chaves desbalanceadas. Ferramentas de validação apontam linha e coluna exata do erro, economizando horas de debug visual.

JSON Schema (avançado)

Para validar não só sintaxe, mas também estrutura (ex.: 'idade tem que ser número e maior que zero'), existe o JSON Schema — uma metaespecificação que descreve a forma esperada do dado. Ferramentas como Ajv (JavaScript) e jsonschema (Python) implementam o padrão.

Dicas para depurar APIs

• Inspecione a aba Network do navegador — veja request e response brutos;
• Confirme o Content-Type da resposta: application/json;
• Cuidado com aspas curvas (“”) ao copiar de documentos Word — só aspas retas (") são válidas;
• Cheque acentos: se vier ?, é problema de encoding (UTF-8 esperado).

Formate o seu

O formatador JSON do UtiliHub aceita JSON em qualquer estado (minificado, mal indentado, com pequenos erros) e tenta produzir saída legível com mensagens de erro precisas. Tudo processado no navegador — seu JSON nunca sai do dispositivo.