O que é JSON? Guia Completo de Sintaxe, Validação e Uso em APIs REST

Resumo Executivo: O JSON (JavaScript Object Notation) é o padrão de fato para troca de dados na web moderna. Neste guia prático, você aprenderá as regras de sintaxe, os tipos de dados aceitos e como evitar erros clássicos que quebram APIs.

O que é JSON?

Criado por Douglas Crockford no início dos anos 2000, o JSON é um formato leve de troca de dados legível por humanos e facilmente interpretado por máquinas. Embora derivado da sintaxe de objetos do JavaScript, o JSON é independente de linguagem — podendo ser usado em Python, PHP, Java, C#, Go e Rust.

Estrutura e Regras de Sintaxe Estritas

Diferente dos objetos JavaScript convencionais, o JSON possui regras de sintaxe extremamente rigorosas:

1. Aspas Duplas Obrigatórias: Todas as chaves (keys) e valores de texto (strings) devem estar entre aspas duplas ("). Aspas simples (') causam erro de sintaxe.
2. Sem Vírgula Sobrando (Trailing Comma): O último elemento de um objeto ou array não pode ter vírgula ao final.
3. Sem Comentários: O padrão JSON oficial não suporta comentários (// ou / /).

Exemplo de JSON Válido:

{
  "usuarioId": 1042,
  "nome": "Carlos Eduardo",
  "email": "carlos@exemplo.com.br",
  "ativo": true,
  "funcoes": ["admin", "editor"],
  "endereco": {
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01000-000"
  },
  "ultimoAcesso": null
}

Tipos de Dados Suportados pelo JSON

O JSON suporta exatamente 6 tipos de dados essenciais:

* String: Textos delimitados por aspas duplas (ex: "Desenvolvedor").

* Number: Números inteiros ou de ponto flutuante (ex: 42 ou 99.90).

* Boolean: true ou false.

* Array: Lista ordenada de valores entre colchetes [ ].

* Object: Coleção de pares chave/valor entre chaves { }.

* Null: Representa um valor nulo ou ausente (null).

Os 4 Erros Mais Comuns que Quebram APIs JSON

1. Utilizar aspas simples: {'nome': 'Ana'} ❌ -> {"nome": "Ana"} ✅
2. Deixar vírgula no final: {"a": 1, "b": 2,} ❌ -> {"a": 1, "b": 2} ✅
3. Esquecer de escapar caracteres especiais: Para incluir aspas dentro de uma string, use barra invertida: "Ele disse \"Olá\"".
4. Inserir comentários: Incluir // comentário invalida todo o documento.

Formate e Valide seu JSON Facilmente

Testar e identar JSON manualmente pode tomar muito tempo. Experimente o Formatador de JSON do DynamicTools para detectar erros de sintaxe em tempo real com destaque colorido.