Noções básicas de sintaxe JSON

Todo documento JSON é construído com um conjunto pequeno de regras de pontuação. Depois de internalizá-las, arquivos inválidos ficam bem mais fáceis de corrigir.

Duas formas estruturais

Os valores JSON são:

• Um objeto — entre { }, com pares chave–valor
• Um array — entre [ ], com lista ordenada de valores

Um arquivo pode ser um único objeto, um único array ou (menos comum) um valor primitivo como "hello" ou 42.

Objetos: chaves e dois-pontos

Dentro de um objeto, cada entrada tem a forma:

"key": value

Regras:

• Chaves devem ser strings entre aspas duplas
• Dois-pontos : separam chave e valor
• Vírgulas , separam entradas — nunca após a última

{
  "id": 1,
  "label": "primary"
}

Arrays: valores ordenados

Arrays listam valores sem chaves:

["red", "green", "blue"]

Tipos mistos são permitidos no mesmo array (diferente de algumas linguagens tipadas), embora APIs costumem manter arrays homogêneos.

Aninhamento

Objetos e arrays podem conter um ao outro sem limite:

{
  "users": [
    { "id": 1, "roles": ["admin", "editor"] },
    { "id": 2, "roles": ["viewer"] }
  ]
}

Espaços em branco

Espaços, tabs e quebras de linha fora de strings são insignificantes. Formatação é para humanos; parsers ignoram espaço extra.

Formas válidas no topo

Válido	Inválido
{ ... }	{ key: "x" } (chave sem aspas)
[ ... ]	'string' (aspas simples)
"text", 42, true, null	{ "a": 1, } (vírgula final)

A próxima lição detalha cada tipo de valor.