O que é JSON e por que aparece em quase todas as APIs?

Publicado em 2026-10-20 por frfrand

JSON explicado para principiantes: objetos, listas, cadenas, números, ejemplo real de una API y errores que impiden leerlo correctamente.

JSON é um formato de texto para representar informações estruturadas que podem ser trocadas por programas escritos em linguagens diferentes. Chama-se JavaScript Object Notation, mas serve também para Python, Java, Go, aplicativos móveis e praticamente qualquer ambiente moderno.

Se você já abriu uma API e encontrou chaves, aspas e dois pontos, provavelmente estava olhando para JSON. A sintaxe parece estranha até que você compreenda que ela apenas descreve dados.

Um exemplo simples de uma loja

{
  "id": 42,
  "nombre": "Teclado mecánico",
  "precio": 79.90,
  "disponible": true,
  "categorias": ["accesorios", "teclados"]
}

As palavras à esquerda são chaves; à direita aparece seu valor. As chaves contêm um objeto, os colchetes contêm uma lista e as aspas indicam texto. Não há nenhuma instrução que seja executada por escrevê-lo.

Quais tipos de valores existem?

JSON suporta cadenas de texto, números, booleanos true e false, o valor null, arrays e objetos. Você pode combinar listas e objetos para representar informações mais complexas.

Não suporta funções, comentários nem datas como tipo especial. Uma data pode ser transmitida como texto seguindo um formato acordado, mas o aplicativo deve interpretá-la.

Por que as APIs o usam tanto?

Imagine um frontend em React que precisa exibir produtos armazenados em um backend Django. Ambos podem concordar em trocar uma lista JSON. O servidor retorna dados; o frontend decide como desenhá-los.

JSON é frequente em HTTP, mas não significa que uma API seja obrigada a utilizá-lo. Há serviços que trocam XML, dados binários ou outros formatos. HTTP transporta mensagens; JSON descreve uma possível representação dos dados.

JSON não é um banco de dados

Podés guardar um arquivo .json no teu disco, mas isso não o transforma em PostgreSQL. Um motor de banco de dados gerencia consultas, transações, concorrência, armazenamento e outros problemas que o formato não resolve.

Também existem bancos de dados que armazenam documentos JSON. Aí o formato faz parte de como os registros são representados, mas o motor continua sendo outra peça.

Erros que aparecem constantemente

Usar aspas simples. Em JSON padrão, chaves e strings devem utilizar aspas duplas.

Deixar uma vírgula final. Isso produz uma sintaxe inválida: {"nome":"Ana",}. Alguns linguagens permitem esse estilo em seus próprios objetos, JSON não.

Adicionar comentários. Uma linha que começa com // não é válida dentro de JSON puro, embora certas variantes o aceitem.

Confundir número e texto. 42 não é o mesmo que "42". E null também não equivale a "null".

Como um programador o utiliza?

Em JavaScript, JSON.parse transforma uma string JSON válida em um valor da linguagem; JSON.stringify converte valores compatíveis para texto JSON. Em Python podes utilizar o módulo padrão json.

Mas há um detalhe importante: JSON bem escrito não significa dado confiável. Se chegar {"admin":true} do navegador, o servidor não deve permitir privilégios administrativos apenas porque a chave existe e tem uma sintaxe válida.

E no ArduMaker?

Muitas interfaces de API e ferramentas de infraestrutura trocam estruturas de dados. Entender JSON ajuda a interpretar respostas, construir integrações e diagnosticar erros sem confundir o formato com a operação que um servidor executa.

Em resumo: JSON é uma gramática para escrever dados. Entender objetos, arrays e tipos de valor permite compreender muitas respostas de APIs sem aprender uma linguagem de programação inteira.

Fontes: Especificação JSON, RFC 8259 · Referência JSON do MDN · O que é uma API.