JSON significa JavaScript Object Notation, mas é usado em praticamente qualquer linguagem. Quando um app pede dados a um servidor, é comum a resposta chegar nesse formato.
A estrutura básica
Um objeto JSON fica entre chaves e guarda pares de chave e valor. A chave sempre vai entre aspas duplas. Por exemplo, um cadastro simples:
{ "nome": "Ana", "idade": 29, "ativa": true }
Os pares são separados por vírgula, e a chave é separada do valor por dois-pontos.
Os tipos de valor
- Texto: entre aspas duplas.
- Número: sem aspas, com ponto para decimais.
- Booleano: true ou false, em minúsculas.
- Nulo: null, para ausência de valor.
- Lista: entre colchetes, com valores separados por vírgula.
- Objeto: outro conjunto entre chaves, que pode ficar dentro de um objeto.
Com isso, dá para representar estruturas complexas, como um pedido com vários itens, cada um com nome, preço e quantidade.
Como ler um JSON grande
- Identifique o abre e fecha de cada chave e colchete.
- Descubra se o topo é um objeto ou uma lista.
- Siga as chaves de fora para dentro, como pastas dentro de pastas.
Editores de código e visualizadores online formatam o JSON com indentação e permitem recolher partes. Evite colar dados pessoais ou sigilosos em sites desconhecidos.
Erros mais comuns
- Vírgula sobrando depois do último item.
- Aspas simples no lugar de aspas duplas.
- Chave sem aspas.
- Falta de fechar chave ou colchete.
- Comentários dentro do arquivo.
Quase todo erro de JSON vem de pontuação, então a mensagem de erro costuma indicar a linha do problema. Use um validador, ou o recurso de análise da própria linguagem, para conferir.
Onde você vai usar
Respostas de APIs, arquivos de configuração, exportação de dados e comunicação entre front-end e back-end. Se ainda não entende como os sistemas conversam, leia O que é API e para que serve, explicado sem complicação. Para receber avisos automáticos entre sistemas, veja Webhook: o que é, como funciona e como receber um com segurança.