Pular para o conteúdo
FoiFácil

JSON: o que é, para que serve e erros comuns de sintaxe

Atualizado em 2026-08-20

O que é JSON

JSON (JavaScript Object Notation) é um formato de texto para representar dados estruturados — pares de chave e valor, listas, textos, números, booleanos e valores nulos. Apesar do nome vir do JavaScript, JSON é usado por praticamente toda linguagem de programação hoje, e é o formato padrão de resposta da maioria das APIs web.

A popularidade do JSON vem da simplicidade: é legível por humanos (diferente de formatos binários) e fácil de interpretar por máquinas (diferente de formatos mais verbosos como XML).

Estrutura básica

Um objeto JSON é delimitado por chaves {} e contém pares de chave-valor:

{
  "nome": "Maria",
  "idade": 32,
  "ativa": true,
  "endereco": null,
  "tags": ["cliente", "vip"]
}

Regras importantes:

  • Chaves de objeto sempre ficam entre aspas duplas, nunca aspas simples
  • O último item de uma lista ou objeto não pode ter vírgula depois dele
  • Valores de texto também usam aspas duplas
  • Números não usam aspas
  • Os únicos valores booleanos válidos são true e false (em minúsculas)
  • Valor ausente é representado por null, não por texto vazio nem por undefined

Erros de sintaxe mais comuns

Quando um JSON não é válido, a maioria dos parsers (incluindo o do navegador) retorna um erro genérico como "Unexpected token" — o que raramente diz onde exatamente está o problema. Os erros mais frequentes são:

1. Vírgula sobrando no final

{
  "a": 1,
  "b": 2,
}

Essa vírgula depois do 2 é inválida em JSON (diferente de JavaScript, onde é aceita). Basta removê-la.

2. Aspas simples em vez de duplas

{ 'nome': 'Maria' }

JSON exige aspas duplas tanto para chaves quanto para valores de texto. Aspas simples não são um formato válido.

3. Chave sem aspas

{ nome: "Maria" }

Em JavaScript isso é aceito (é um objeto literal, não JSON), mas em JSON puro toda chave precisa estar entre aspas duplas.

4. Números com formatação regional

{ "preco": 19,90 }

JSON usa ponto como separador decimal, não vírgula. O valor correto seria 19.90.

5. Comentários

JSON não tem suporte nativo a comentários. Um // comentário ou / comentário / dentro de um arquivo JSON puro é inválido (alguns formatos derivados, como JSON5 ou JSONC, permitem, mas não são JSON padrão).

Como validar e formatar

Formatar um JSON compactado em uma única linha com indentação legível ajuda bastante a encontrar erros visualmente. Use o formatador e validador de JSON para colar o texto, ver a indentação organizada e, se houver erro, a posição aproximada onde ele ocorre.

Minificar (remover todos os espaços desnecessários) é útil no sentido contrário: quando o JSON já está correto e você precisa do menor tamanho possível para enviar por rede.

JSON e segurança

Como o JSON é só texto estruturado, ele não executa código por si só — diferente de formatos que permitem scripts embutidos. Ainda assim, ao processar JSON vindo de uma fonte não confiável (por exemplo, um upload de usuário), é importante usar sempre o parser nativo da linguagem (JSON.parse em JavaScript) em vez de eval() ou equivalentes, que poderiam executar código arbitrário disfarçado de JSON.

Ferramentas relacionadas