Toda a gente já perdeu uma tarde por causa de uma vírgula a mais num JSON. A solução não é "ter mais cuidado", é automatizar a validação em cada passo: no editor (hooks de pre-commit), na CI e — quando não tens mais nada à mão — num formatador online que valide enquanto escreves.
O fluxo típico
- Cola a resposta da API no formatador de JSON.
- Clica em "Validar": diz-te se o documento está correto e, se não estiver, a linha e coluna exatas do erro.
- Com "Formatar" organizas com 2 ou 4 espaços.
- Quando vais publicar algo num
.jsonde produção, usa "Minificar" para remover espaços e poupar bytes.
Minificar: quanto peso poupas
Espaços, tabulações e quebras de linha costumam representar 15–30 % do peso de um JSON. O formatador mostra-te os bytes poupados em cada minificação. Para ainda mais, combina a minificação com nomes de chave curtos e sem CamelCase inflacionado.
Erros frequentes e como se veem
- Vírgula depois do último elemento — o clássico do diff no Git.
- Aspas duplas — o JSON não aceita aspas simples; é o erro n.º 2.
- Números com zeros à esquerda —
01não é JSON válido. - Ponto decimal final –
1.também não.
JSON ↔ CSV ↔ YAML
No mesmo editor também podes converter em ambas as direções: JSON para CSV (array de objetos → tabela) e JSON para YAML (para configurações de Docker Compose, Ansible ou Kubernetes). Cada ferramenta respeita a sintaxe de destino e avisa-te se algo não for convertível.
Quando o JSON é grande: árvore, Schema e tipos
Um JSON aninhado com várias centenas de linhas é difícil de ler em texto simples. A árvore JSON apresenta-o como uma estrutura colapsável para navegares diretamente até à chave que procuras, sem scroll infinito.
Se o JSON é a resposta de uma API que vais consumir em TypeScript, não escrevas o tipo à mão: cola o JSON no conversor para TypeScript e gera as interface automaticamente, com os tipos aninhados resolvidos. E se precisares de documentar ou validar a forma do documento (por exemplo, para um contrato de API), o gerador de JSON Schema constrói o $schema a partir de um exemplo real.
A regra de ouro: valida antes de guardar, minifica antes de publicar.