JSON explicado

JSON (JavaScript Object Notation) é um formato para armazenar e transmitir dados. É usado em APIs, configurações e praticamente tudo na web.

Sintaxe básica

{
  "nome": "Jean",
  "idade": 25,
  "ativo": true,
  "hobbies": ["games", "código", "música"],
  "endereco": {
    "cidade": "São Paulo",
    "estado": "SP"
  }
}

Tipos de dados

Tipo	Exemplo
String	`"texto"`
Número	`42`, `3.14`
Boolean	`true`, `false`
Array	`[1, 2, 3]`
Objeto	`{"chave": "valor"}`
Null	`null`

Onde JSON aparece

APIs

Toda API moderna retorna JSON:

const response = await fetch("/api/users");
const data = await response.json();
// data = [{ "nome": "Jean", "email": "[email protected]" }]

package.json

Configuração do seu projeto Node.js:

{
  "name": "meu-app",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  },
  "dependencies": {
    "next": "^15.0.0",
    "react": "^19.0.0"
  }
}

veloz.json

Configuração do deploy na Veloz:

{
  "version": "1.0",
  "project": {
    "id": "proj_abc123",
    "name": "meu-app"
  }
}

Erros comuns

// ❌ Aspas simples não funcionam
{ 'nome': 'Jean' }
 
// ❌ Vírgula no último item
{ "nome": "Jean", }
 
// ❌ Comentários não existem em JSON
{ "nome": "Jean" // isso é um nome }
 
// ✅ Correto
{ "nome": "Jean" }

Dica

Use um formatador de JSON quando estiver confuso. No VS Code: selecione o JSON, ⌘+Shift+P → "Format Document".

JSON explicado para quem nunca viu código