JSON inválido: como localizar uma vírgula errada e organizar os dados

Uma integração falha e o servidor responde que o JSON está inválido. Você abre o conteúdo e encontra chaves, colchetes e dezenas de linhas sem recuo. Antes de procurar um problema complexo na API, vale confirmar o básico: o documento é um JSON válido?

Formatar facilita enxergar a estrutura

Um Formatador JSON reorganiza espaços e indentação para mostrar onde cada objeto começa e termina. Ele também pode apontar erros de sintaxe. Erros comuns incluem vírgula extra depois do último item, aspas simples no lugar de aspas duplas e nomes de propriedades sem aspas.

O JSON aceita strings, números, booleanos, valores nulos, listas e objetos. A palavra true é diferente da string "true"; uma API que espera um booleano pode rejeitar a segunda. A formatação melhora a leitura, mas não confirma que os nomes e tipos estão de acordo com o contrato do serviço.

Mensagens de erro servem como pista

Quando um validador indicar uma linha, examine também a anterior. Um delimitador aberto acima pode provocar erro apenas quando o parser encontra o próximo elemento. Em dados gerados automaticamente, compare a primeira e a última parte do arquivo para descobrir se houve truncamento.

Nunca compartilhe segredos por descuido

Antes de copiar um JSON para ambientes externos, retire tokens, senhas e dados pessoais. Se o conteúdo for sensível, prefira ferramentas que processam localmente e revise como funcionam. Depois de corrigir a sintaxe, teste com o sistema real: um JSON válido ainda pode conter informações erradas.

JSON bonito ainda pode estar errado

Um objeto pode ser sintaticamente válido e mesmo assim enviar a data em um formato que o serviço não aceita. Por exemplo, a API espera uma lista de produtos, mas recebe um único objeto; o formatador não tem como saber o contrato dessa integração. Depois de arrumar a indentação, confira a documentação do sistema, os nomes exatos das propriedades e quais campos são obrigatórios.

Se você está depurando um erro, reduza o exemplo sem apagar o comportamento problemático. Um JSON menor facilita perceber um tipo incorreto ou uma propriedade repetida. Não esqueça que caracteres de controle, aspas e barras invertidas dentro de strings precisam obedecer às regras do formato. Em logs compartilhados com terceiros, substitua credenciais e informações pessoais por valores fictícios antes de enviar.