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.
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
- Objeto: coleção de pares chave e valor, entre chaves.
- Array: lista ordenada de valores, entre colchetes.
- String: texto entre aspas duplas.
- Número: inteiro ou decimal, sem aspas.
- Boolean: true ou false.
- null: ausência de valor.
Exemplo simples
Um objeto JSON descrevendo uma pessoa teria uma chave nome com uma string, uma chave idade com um número, uma chave ativo com um boolean e uma chave tags com um array de strings. Cada par é separado por vírgula, e o objeto inteiro fica entre chaves. As chaves sempre vêm entre aspas duplas, e não pode haver vírgula sobrando após o último par.
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.