O JSON descreve objetos, arrays, números, strings e nada mais, o que basta para a maioria dos dados e é simples o suficiente para que toda linguagem o leia sem discussão sobre qual biblioteca usar. É o que as APIs devolvem, o formato em que se escrevem os arquivos de configuração e o que vai parar no armazenamento local do navegador. A vantagem dele sobre o CSV é o aninhamento: um cliente com três endereços e uma lista de pedidos fica natural em JSON e desajeitado numa tabela.

Formatar, minificar e por que existem os dois

O mesmo JSON pode ser uma única linha comprida ou uma árvore indentada; as máquinas preferem a primeira, as pessoas precisam da segunda. Minificar remove todo espaço que não está dentro de uma string e pode reduzir à metade o tamanho dos dados transmitidos, o que faz diferença na rede. Formatar devolve a indentação e é a diferença entre achar uma vírgula faltando em dez segundos e não achá-la nunca. Nenhum dos dois altera os dados, e ambos podem ser aplicados quantas vezes você quiser, ao contrário de codificar uma imagem de novo.

Converter de e para tabelas

Achatar um JSON em CSV ou Excel funciona quando os dados são, na prática, uma lista de registros parecidos; não funciona quando os objetos se aninham em muitos níveis, porque uma tabela não tem como expressar uma lista dentro de uma célula. As conversões daqui seguem o caminho pragmático: caminhos aninhados viram nomes de coluna com pontos, e a ferramenta avisa quando uma estrutura não pode ser achatada, em vez de descartá-la sem aviso. No sentido inverso, de uma tabela para JSON, é sempre seguro: cada linha vira um objeto.

Converter JSON para CSV ou Excel sem perder a estrutura

Uma exportação JSON de uma API costuma ser uma lista de registros, e é exatamente isso que uma tabela quer. O que não se encaixa são objetos e arrays aninhados. JSON para CSV achata caminhos aninhados em nomes de coluna com pontos (customer.address.city) e deixa você decidir o que acontece com um array: os valores unidos numa célula, uma coluna por item ou o JSON bruto mantido numa única célula. Tudo o que estiver aninhado além da profundidade definida fica na sua célula como texto JSON, em vez de ser descartado. JSON para Excel faz o mesmo numa pasta de trabalho de verdade, a melhor escolha quando uma pessoa vai ler o resultado. Quando os registros estão dentro de um objeto que os envolve, informe o caminho até eles, por exemplo data.items.

Perguntas frequentes

Como abrir um arquivo JSON?

Qualquer editor de texto mostra o texto bruto, e a ferramenta Formatar JSON o deixa legível: indenta o conteúdo e aponta o primeiro erro de sintaxe. Para ver como tabela, converta para CSV ou Excel; para inspecionar, formatar já basta.

Por que meu JSON está inválido?

Quase sempre é uma vírgula sobrando no final, uma string entre aspas simples ou um comentário, e o JSON não permite nenhum dos três. Formatar JSON informa a linha e a coluna do primeiro erro; o modo tolerante também aceita comentários e vírgulas no final e devolve o resultado como JSON estrito.

Dá para converter JSON para Excel com dados aninhados?

Sim, desde que os dados sejam uma lista de registros parecidos. Objetos aninhados viram colunas com pontos, arrays viram células com os valores unidos, colunas separadas ou texto JSON, e tudo o que estiver aninhado além do limite que você definir fica na sua célula como JSON, em vez de se perder sem aviso.