Ferramentas
Formatador e Validador de JSON
Cole seu JSON para formatar com indentação legível, validar a sintaxe e identificar erros com localização exata. Também minifica JSON para produção.
JSON mal formatado é um dos bugs mais difíceis de depurar
Uma vírgula fora do lugar, aspas simples onde deveria haver duplas ou um campo com valor
undefined são suficientes para fazer uma aplicação inteira falhar. O problema
é que a mensagem de erro do parser muitas vezes diz apenas "unexpected token" sem indicar
exatamente onde o problema está em um JSON com centenas de linhas.
Este formatador analisa o JSON, exibe a estrutura com indentação clara e, em caso de erro, aponta a linha e coluna exatas. Para fluxos de produção, a função de minificação remove espaços desnecessários, reduzindo o tamanho do payload sem alterar os dados.
Regras de sintaxe que o JSON impõe e o JavaScript não
JSON é um subconjunto do JavaScript, mas com regras mais estritas. Todas as chaves de
objetos devem ser strings entre aspas duplas — {"nome": "valor"} é válido,
mas {nome: "valor"} não é. Strings também só aceitam aspas duplas; aspas
simples são inválidas. O formato não suporta comentários de nenhum tipo, ao contrário
de linguagens como JavaScript ou YAML.
Outro ponto crítico é a vírgula trailing: em JavaScript, [1, 2, 3,] é
válido. Em JSON, a vírgula após o último elemento causa erro de parse. Como muitos
desenvolvedores escrevem JSON com a mentalidade do JavaScript, essa é de longe a fonte
de erro mais comum ao construir payloads manualmente.
Quando usar pretty-print e quando minificar
JSON formatado com indentação (pretty-print) é indispensável durante o desenvolvimento: facilita revisão de código, é legível em logs e torna comparações em diffs muito mais claras. Ferramentas de documentação de API como Swagger/OpenAPI e Postman exibem JSON formatado por padrão por esse motivo.
Em produção, JSON minificado é a escolha certa. Para APIs de alta frequência que retornam grandes volumes de dados, a economia de 20% a 40% no tamanho do payload se traduz diretamente em menor uso de banda e respostas mais rápidas. A maioria dos frameworks web modernos minifica JSON automaticamente antes de enviar respostas ao cliente.
JSON em APIs REST: boas práticas
APIs REST bem projetadas usam JSON com convenções consistentes: camelCase para nomes
de campos em APIs JavaScript/Node.js, snake_case em Python e Ruby. Datas devem seguir
o formato ISO 8601 (ex: 2024-03-15T10:30:00Z). Valores monetários devem
ser representados como strings ou inteiros em centavos — nunca como floats, que podem
introduzir erros de precisão de ponto flutuante.
O campo Content-Type: application/json deve sempre acompanhar respostas
e requisições com corpo JSON. Sem ele, alguns clientes tentarão interpretar o corpo
como texto simples ou HTML, causando falhas silenciosas de parse.
JSON5 e alternativas para configurações
JSON5 é uma extensão do JSON que adiciona recursos ausentes pensando em arquivos de
configuração escritos por humanos: comentários com // e /* */, vírgulas trailing,
strings com aspas simples e chaves sem aspas. Arquivos .eslintrc e
alguns outros arquivos de config suportam JSON5 exatamente por esse motivo.
JSONC (JSON with Comments) é outra variante, usada pelo VS Code em seus arquivos de configuração. Para dados de aplicação trafegados entre sistemas, sempre use JSON padrão para máxima compatibilidade. Reserve JSON5 e JSONC para arquivos de configuração onde a legibilidade e manutenção manual são prioritárias.
Perguntas frequentes
O que é JSON?
JSON (JavaScript Object Notation) é um formato leve de troca de dados baseado em texto. Apesar do nome fazer referência ao JavaScript, é independente de linguagem e suportado nativamente por praticamente todas as linguagens modernas. Representa dados como pares chave-valor e listas ordenadas, tornando-o ideal para APIs REST, arquivos de configuração e armazenamento de dados estruturados.
Quais são os erros de sintaxe mais comuns no JSON?
Os erros mais frequentes são: vírgula trailing (vírgula após o último elemento de um objeto ou array — válida em JavaScript mas inválida em JSON), uso de aspas simples em vez de duplas para strings e chaves, comentários (JSON não suporta comentários), valores undefined (apenas null é válido), e números com zeros à esquerda como 007. O formatador identifica a linha e coluna exata do erro.
Qual a diferença entre JSON pretty-print e minificado?
JSON pretty-print (formatado) usa indentação e quebras de linha para tornar a estrutura visualmente legível — ideal para debug, revisão de código e documentação. JSON minificado remove todos os espaços e quebras de linha desnecessários, reduzindo o tamanho do arquivo. Para APIs em produção, JSON minificado economiza banda. A diferença pode ser de 20% a 40% no tamanho dependendo da estrutura.
JSON é melhor do que XML?
Para APIs web modernas, JSON é geralmente preferível: sintaxe mais concisa, parsing nativo em JavaScript, melhor integração com bancos NoSQL e payloads menores. XML ainda tem vantagens em contextos específicos: suporte a namespaces, schemas com XSD, transformações com XSLT e sistemas legados como SOAP. A escolha depende do ecossistema e dos requisitos do projeto.
O que é validação de JSON Schema?
JSON Schema é um vocabulário que permite descrever a estrutura esperada de um documento JSON — tipos de campos, campos obrigatórios, formatos, valores mínimos e máximos. É diferente de validar se o JSON é sintaticamente correto; o Schema valida se os dados estão semanticamente corretos para uma aplicação específica. Ferramentas como Ajv (JavaScript) implementam validação contra schemas.
Como depuro erros de JSON em respostas de API?
Cole a resposta da API neste formatador. Se houver erro de sintaxe, a ferramenta indicará a linha e coluna exatas do problema. Erros comuns em respostas de API incluem: HTML de erro retornado com Content-Type incorreto, caracteres de controle não escapados no meio de strings, e truncamento de resposta por timeout ou limite de tamanho. Após identificar o problema, verifique os logs do servidor para o erro original.