O que é JSON? Um guia completo para iniciantes

O que é JSON?

JSON é um formato baseado em texto para representar dados estruturados. Ele foi derivado da sintaxe de literais de objeto do JavaScript, mas é independente de linguagem: praticamente toda linguagem de programação consegue ler e produzir JSON.

Foi introduzido por Douglas Crockford no início dos anos 2000 como uma alternativa mais simples ao XML. Hoje é um padrão internacional (ECMA-404 / RFC 8259) e o formato padrão de payload para APIs REST, GraphQL e a maioria dos serviços web.

Noções básicas da sintaxe JSON

O JSON tem duas estruturas: objetos (mapas de chave/valor delimitados por chaves) e arrays (listas ordenadas delimitadas por colchetes). As chaves precisam ser strings com aspas duplas; os valores podem ser de qualquer um dos seis tipos de dados.

{
  "name": "Alice",
  "age": 30,
  "active": true,
  "roles": ["admin", "editor"],
  "address": {
    "city": "San Francisco",
    "zip": "94102"
  },
  "metadata": null
}

Observe as regras: as chaves usam aspas duplas (aspas simples são inválidas), os itens são separados por vírgulas e não há vírgula final após o último item.

Os seis tipos de dados

O JSON oferece exatamente seis tipos de dados. Entendê-los é a base para trabalhar com qualquer JSON.

string — texto entre aspas duplas, p.ex. "hello". number — inteiros ou decimais, p.ex. 42 ou 3.14. boolean — true ou false (sem aspas). null — um valor vazio explícito. object — um mapa { } de pares chave/valor. array — uma lista ordenada [ ].

É só isso. O JSON não tem datas, funções nem undefined — eles precisam ser codificados como strings ou omitidos. Esse minimalismo é o que torna o JSON tão universalmente interoperável.

Onde o JSON é usado

APIs: quase todo endpoint REST e GraphQL troca JSON. Configuração: package.json, tsconfig.json e inúmeros arquivos de configuração de ferramentas são JSON. Bancos de dados: MongoDB, CouchDB e o JSONB do PostgreSQL armazenam documentos como JSON. Troca de dados: o formato de transmissão entre servidor e navegador nas aplicações web modernas.