O que é JSON? Um guia para iniciantes com exemplos

Se você já tocou em uma API, em um arquivo de configuração ou em algum desenvolvimento web moderno, você conheceu o JSON. É o formato de facto para a troca de dados entre sistemas – legível o suficiente para humanos, suficientemente rigoroso para máquinas. Aqui está um tour para iniciantes sobre o que é e como trabalhar com ele.

O que é JSON

JSON significa Notação de Objeto JavaScript. Apesar do nome, é independente de linguagem – praticamente todas as linguagens de programação podem lê-lo e escrevê-lo. Ele representa dados como pares de valores-chave e listas ordenadas, que juntos podem descrever quase todos os dados estruturados.

Um exemplo simples

{
"name": "Ada Lovelace",
"age": 36,
"isMathematician": true,
"idiomas": ["Inglês", "Francês"]
}

Esse é um objeto com quatro chaves. Observe os tipos de dados: uma string entre aspas, um número, um booleano e uma matriz de strings. JSON suporta strings, números, booleanos, nulos, objetos e matrizes — esse é todo o vocabulário.

As regras que enganam as pessoas

• As chaves devem estar entre aspas duplas — aspas simples são inválidas.
• Sem vírgulas no final — uma vírgula após o último item o separa.
• Sem comentários — JSON não tem sintaxe de comentários (uma surpresa frequente).
• Strings usam apenas aspas duplas, nunca simples.

Essas pequenas regras causam a maioria dos erros de "JSON inválido". A gramática oficial é definida em json.org.

Como ler e corrigir JSON confuso

As APIs retornam JSON reduzido em uma linha, o que é ilegível. Cole-o em nosso formatador JSON para obter uma saída limpa e recuada — e uma mensagem de erro instantânea identificando qualquer erro de sintaxe. É a maneira mais rápida de depurar uma carga malformada.

Onde você conhecerá o JSON

Respostas de API, arquivos de configuração (como package.json), a carga útil de um JWT, bancos de dados NoSQL e localStorage do navegador usam JSON. Depois que você puder lê-lo confortavelmente, uma enorme quantidade de ferramentas modernas será aberta.

JSON versus XML

O JSON substituiu amplamente o XML pelas APIs da Web porque é mais leve e fácil de ler. XML ainda aparece em alguns contextos corporativos e de documentos, mas para novos trabalhos na web, JSON é o padrão. Se você precisar alternar entre formatos, nossos conversores também cuidam disso.

Aninhamento: como os dados reais são estruturados

Os exemplos acima são simples, mas o JSON real aninha objetos e matrizes uns dentro dos outros para modelar dados complexos. Um objeto de usuário pode conter um objeto "endereço" e uma matriz de "pedidos", sendo cada pedido um objeto. Esse aninhamento é o que permite que o JSON descreva quase tudo - mas também é onde a legibilidade é prejudicada, porque o JSON minificado profundamente aninhado é impossível de acompanhar a olho nu. É exatamente aí que um formatador ganha seu sustento, recuando cada nível para que a estrutura se torne visível à primeira vista.

Erros JSON comuns e como corrigi-los

A maioria das falhas de "JSON inválido" vem de um pequeno punhado de erros: uma vírgula final após o último item, aspas simples em vez de duplas, uma chave sem aspas ou um comentário perdido. A parte frustrante é que um caractere incorreto invalida todo o documento e a mensagem de erro pode apontar para o local errado. Colar em um validador que destaca a linha exata economiza tempo real – ele identifica a vírgula ou citação que o olho humano ignora.

JSON além das APIs

Quando estiver familiarizado com a leitura do JSON, você o verá em todos os lugares: arquivos de configuração como package.json, definições de infraestrutura, bancos de dados NoSQL como MongoDB, localStorage do navegador e as cargas dentro de JWTs. Tornou-se a língua franca da troca de dados precisamente porque é simples, legível por humanos e tem suporte em qualquer lugar. A fluência em JSON libera silenciosamente uma enorme quantidade de ferramentas modernas.

Resultado

JSON é uma maneira simples e universal de representar dados estruturados com chaves, valores e matrizes. Aprenda algumas regras rígidas – aspas duplas, sem vírgulas finais, sem comentários – e conte com um formatador para validá-lo e organizá-lo. É um dos formatos mais úteis para se ter fluência. Para mais ajudantes diários, consulte nosso kit de ferramentas para desenvolvedores web.