Tutorial JSON

JSON é um formato leve usado em APIs e configs. Este guia cobre sintaxe essencial e padrões comuns.

O que é JSON?

JSON baseia-se em objetos JavaScript, mas é texto puro e independente de linguagem.

JSON válido tem um único valor raiz: objeto {...} ou array [...].

Regras básicas

Chaves e strings com aspas duplas; \ escapa caracteres.

Vírgulas entre elementos, sem vírgula final. Sem comentários ou undefined.

Números sem zeros à esquerda; true/false em minúsculas.

Seis tipos

string, number, boolean, null, object, array:

{
  "name": "Alice",
  "age": 30,
  "active": true,
  "score": null
}

Strings e escape

Aspas duplas, UTF-8, sequências \n, \t, \", \\

{
  "message": "Hello\nWorld",
  "quote": "He said \"Hi\"",
  "path": "C:\\Users\\data",
  "emoji": "你好 🎉",
  "unicode": "\u0041"
}

Números, booleanos e null

Inteiros, decimais, negativos, notação científica. null = vazio.

{
  "count": 42,
  "price": 19.99,
  "negative": -1,
  "scientific": 1.5e10,
  "flag": true,
  "disabled": false,
  "empty": null
}

Estruturas vazias

[] array vazio, {} objeto vazio, "" string vazia.

{
  "tags": [],
  "meta": {},
  "note": ""
}

Objetos

Pares chave:valor em {}.

{
  "user": {
    "id": 1001,
    "email": "alice@example.com"
  }
}

Arrays

Elementos ordenados em []; também podem ser raiz:

Array no objeto
{
  "tags": ["json", "tutorial", "web"],
  "scores": [95, 88, 72]
}
Array raiz
[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" }
]

Aninhamento

Objetos e arrays em vários níveis.

{
  "project": "QyCreate JSON",
  "version": 1,
  "features": ["format", "validate", "minify"],
  "settings": {
    "indent": 2,
    "theme": "light"
  },
  "contributors": [
    { "name": "Alice", "role": "author" },
    { "name": "Bob", "role": "reviewer" }
  ]
}

JSON vs JavaScript

JSON é formato de dados, não código. Sem comentários, funções ou undefined.

JSON.parse() / JSON.stringify(); JSON5 é extensão.

Erros comuns

Chaves sem aspas, aspas simples, vírgula final:

Inválido
{
  name: "Alice",
  "items": [1, 2, 3,],
}
Correto
{
  "name": "Alice",
  "items": [1, 2, 3]
}

Pratique com a ferramenta

Cole JSON ou envie até 4 MB. Carregar exemplo, formatar e minificar—a indentação facilita ler estruturas aninhadas.

Erros com linha/coluna; desfazer/refazer; copiar ou baixar—tudo local.