O que é JSON
JSON é o formato de dados mais usado em APIs e integrações entre sistemas. Ele organiza as informações em pares de chave e valor (objetos, entre chaves) e em listas (arrays, entre colchetes). Os valores podem ser texto, número, verdadeiro ou falso, nulo, ou outros objetos e listas.
{
"cliente": "Empresa Exemplo",
"ativo": true,
"contatos": ["financeiro@exemplo.com.br", "ti@exemplo.com.br"]
}
Os erros de sintaxe mais comuns
- Vírgula sobrando no último item:
{"a": 1, "b": 2,}. O JSON não aceita vírgula antes de fechar o objeto ou a lista. - Aspas simples:
{'nome': 'Ana'}é inválido. Chaves e textos precisam de aspas duplas. - Chave sem aspas:
{nome: "Ana"}funciona em JavaScript, mas não é JSON válido. - Comentários:
//e/* */não são permitidos em JSON. - Aspas dentro de texto: precisam de barra invertida antes, como em
"descrição com \"aspas\"". - Caracteres invisíveis: textos copiados de e-mail, Word ou PDF podem trazer aspas tipográficas (“ ”) ou espaços especiais que quebram o JSON.
- Valores especiais:
undefined,NaNe datas sem aspas não existem em JSON.
Quando há erro, a ferramenta indica a posição em que a leitura falhou. Muitas vezes o problema real está pouco antes do ponto indicado, como uma vírgula ou aspas esquecidas na linha anterior.
Quando esta ferramenta ajuda
- Ler a resposta de uma API que vem em uma linha só.
- Encontrar o erro em um arquivo de configuração que impede um sistema de iniciar.
- Conferir o conteúdo enviado ou recebido por uma integração antes de abrir chamado com o fornecedor.
- Revisar a saída de automações (Power Automate, Zapier, Make, webhooks).
Cuidado com dados sensíveis
A formatação é feita no seu navegador, e o conteúdo não é enviado ao nosso servidor. Ainda assim, evite colar tokens de acesso, senhas e chaves de API em ferramentas online em geral. Se precisar compartilhar um JSON com alguém para análise, remova ou mascare esses campos antes.
Perguntas frequentes
O JSON que eu colo aqui é enviado para algum servidor?
Não. A validação e a formatação acontecem no seu navegador.
Qual a diferença entre JSON e um objeto JavaScript?
O JSON é um formato de texto inspirado na sintaxe de objetos do JavaScript, mas com regras mais rígidas: aspas duplas obrigatórias em chaves e textos, sem vírgula final, sem comentários e sem funções.
A ferramenta disse que o erro está numa linha, mas ela parece certa. Por quê?
O leitor aponta onde percebeu o erro, não onde ele começou. Confira a linha anterior: vírgula faltando, aspas não fechadas ou chave sem fechamento são as causas mais comuns.
JSON ou XML: qual é melhor?
Para APIs modernas, o JSON é o padrão por ser mais leve e mais fácil de ler. O XML continua presente em sistemas corporativos, em serviços SOAP e na nota fiscal eletrônica.