JSON é o formato de dados mais usado na web moderna: APIs, configurações, bancos de dados e integrações trocam informação em JSON o tempo todo. Entender sua estrutura e seus erros comuns evita muita dor de cabeça. Neste guia você vê o que é JSON, os tipos de dados, a diferença para um objeto JavaScript e por que validar antes de usar. Para formatar e validar, use o formatador e validador de JSON.
Resposta rápida
- JSON é um formato de texto para troca de dados, em pares chave/valor; independente de linguagem.
- Tem 6 tipos: objeto, array, string, número, boolean e null.
- É estrito: aspas duplas nas chaves, sem vírgula no fim, sem comentários nem funções.
- Validar antes de usar evita erros de parse e falhas em APIs.
O que é JSON
JSON (JavaScript Object Notation) é um formato de texto leve para representar e transmitir dados. Apesar do nome, é independente de linguagem: praticamente toda linguagem moderna sabe ler e gerar JSON. Sua popularidade vem da simplicidade: é fácil de ler, escrever e processar.
Os tipos de dados
| Tipo | Sintaxe | Exemplo |
|---|---|---|
| Objeto | entre chaves | { "nome": "Ana" } |
| Array | entre colchetes | [1, 2, 3] |
| String | aspas duplas | "texto" |
| Número | sem aspas | 42 ou 3.14 |
| Boolean | palavra reservada | true / false |
| null | palavra reservada | null |
Exemplo simples
Um objeto JSON descrevendo uma pessoa combina vários tipos. Cada par é separado por vírgula, o objeto fica entre chaves, as chaves vêm entre aspas duplas e não pode haver vírgula sobrando após o último par:
{
"nome": "Ana",
"idade": 30,
"ativo": true,
"tags": ["dev", "design"],
"telefone": null
}JSON x objeto JavaScript
Embora pareçam iguais, há diferenças importantes. O JSON é estrito: chaves sempre entre aspas duplas, sem comentários, sem funções e sem vírgula final. Um objeto JavaScript é mais flexível: aceita aspas simples, chaves sem aspas, funções e comentários. Por isso, copiar um objeto do código e tratar como JSON costuma gerar erro de sintaxe.
Erros comuns
- Usar aspas simples em vez de aspas duplas.
- Deixar vírgula após o último item de um objeto ou array.
- Esquecer de fechar chaves ou colchetes.
- Colocar comentários, que não existem no JSON padrão.
- Usar chaves sem aspas.
Por que validar antes de usar em uma API
Um JSON malformado quebra a comunicação: a API rejeita a requisição ou o sistema lança um erro de parse. Validar e formatar antes de enviar evita falhas difíceis de rastrear. Ferramentas como o validador de JSON apontam exatamente onde está o problema. Para outras tarefas de desenvolvimento, veja o codificador Base64, o URL encoder/decoder e o guia o que é JWT.
Segurança
Ferramentas de JSON devem processar tudo localmente. No ValorFinal, o conteúdo que você cola não sai do seu navegador. Mesmo assim, tenha cuidado ao colar dados sensíveis em ferramentas online de terceiros: só use as que garantem processamento local. Veja também como validamos os cálculos.
Fontes oficiais
- ECMA-404: especificação da sintaxe do JSON.
- RFC 8259: padrão IETF para o formato JSON.
- MDN Web Docs (JSON): referência prática de uso.
Conclusão
JSON é simples, mas exige rigor: aspas duplas, sem vírgula sobrando e sem comentários. Conhecer os tipos de dados e os erros comuns evita falhas de parse e problemas em APIs. Para formatar e validar, use o formatador e validador de JSON, explore o guia de conversão entre CSV, JSON, YAML e XML e conheça as demais ferramentas de tecnologia.