Como formatar JSON online: embelezar, validar e corrigir erros

Voce copia uma resposta JSON de uma API, cola no seu editor e encontra uma unica linha longa e ininterrupta de texto, sem nenhum espacamento. Em algum lugar daquela parede de caracteres esta o valor de que voce precisa, mas le-lo a olho nu e quase impossivel. Formatar JSON resolve exatamente isso. Este guia explica o que o embelezamento e a validacao de JSON realmente fazem, e como o Formatador de JSON gratuito transforma dados baguncados em algo que voce consegue ler.

O que significam formatar e validar

Sao duas tarefas distintas que boas ferramentas tratam juntas.

Formatar (tambem chamado de embelezar ou imprimir de forma legivel) adiciona quebras de linha e indentacao para que a estrutura dos dados se torne visivel. Os objetos aninhados recuam para dentro, os arrays se alinham e cada chave fica em sua propria linha. Os dados nao mudam em nada, apenas a sua apresentacao.

Validar verifica se o texto e, antes de mais nada, um JSON valido. O JSON tem regras rigorosas: as chaves precisam estar entre aspas duplas, as strings nao podem usar aspas simples e nao existem comentarios. Um validador informa se o documento e analisado corretamente e, caso contrario, aponta onde ele quebrou.

Normalmente voce quer as duas coisas. Formatar para le-lo, validar para confiar nele.

Por que o JSON minificado e ilegivel

O JSON trocado entre servidores quase sempre esta minificado, ou seja, cada espaco e quebra de linha opcional foi removido. Isso e bom para as maquinas: cargas menores trafegam mais rapido e consomem menos banda. E pessimo para as pessoas.

Um objeto minificado se parece com {"user":{"id":42,"roles":["admin","editor"],"active":true}}. Isso e gerenciavel. Mas uma resposta de API real pode se estender por milhares de caracteres em uma unica linha, com objetos aninhados em cinco niveis de profundidade. Sem indentacao voce nao consegue saber onde um objeto termina e o proximo comeca, e combinar uma chave de fechamento com a sua abertura vira pura adivinhacao. A formatacao restaura a hierarquia visual para que o formato dos dados corresponda ao formato na sua tela.

Detectando erros de sintaxe comuns

A maioria dos problemas de JSON vem de um punhado de pequenos erros. Um validador os detecta na hora, em vez de deixa-los falhar silenciosamente em algum ponto mais adiante. Fique atento a estes:

• Virgulas finais. Uma virgula apos o ultimo item de um objeto ou array, como {"a":1,}, e valida em JavaScript, mas proibida em JSON.
• Aspas simples. O JSON exige aspas duplas. {'name':'Sam'} nao sera analisado.
• Aspas faltando nas chaves. Toda chave precisa estar entre aspas: {name:"Sam"} e invalido.
• Caracteres sem escape. Uma quebra de linha bruta ou uma aspa sem escape dentro de uma string quebra a analise.
• Colchetes nao correspondentes. Um unico } ou ] faltando descarrilha o documento inteiro.

Quando o Formatador de JSON reporta um erro, leia a posicao que ele indica e olhe logo antes daquele ponto. O erro real costuma estar um caractere antes de onde o analisador finalmente desistiu.

Lendo respostas de API com confianca

Quando voce esta depurando uma integracao, formatar e a maneira mais rapida de entender o que um endpoint realmente retornou. Cole a resposta bruta, embeleze-a e voce ve de imediato quais campos existem, se uma lista voltou vazia e quao profundo e o aninhamento. Isso transforma um vago “os dados parecem errados” em um preciso “esta faltando o campo price no array items”.

Como o Formatador de JSON e gratuito, nao exige cadastro e roda inteiramente no seu navegador, a resposta que voce cola nunca sai do seu dispositivo. Isso importa quando uma carga contem tokens, enderecos de e-mail ou qualquer outra coisa que voce nao gostaria de enviar para um servidor qualquer apenas para le-la.

Trabalhando com formatos relacionados

O JSON raramente vive sozinho, e converter entre formatos e um proximo passo comum. Se voce tem dados em uma exportacao de planilha e precisa deles como JSON estruturado, o conversor de CSV para JSON transforma linhas e colunas em objetos que voce pode inserir direto no codigo. Se voce esta extraindo dados de um sistema antigo ou de um servico SOAP, o conversor de XML para JSON remodela as tags em pares chave-valor limpos. E quando um campo JSON contem um bloco codificado, a ferramenta de codificar e decodificar Base64 o decodifica para que voce veja o que realmente ha dentro.

A versao curta

A formatacao torna o JSON legivel ao restaurar a indentacao, e a validacao confirma que o documento e realmente valido antes de voce depender dele. Juntas, elas transformam uma string minificada e propensa a erros em algo em que voce pode confiar e sobre o qual pode raciocinar. Da proxima vez que uma API lhe entregar uma linha de texto ilegivel, cole-a no Formatador de JSON, deixe que ele a embeleze e verifique a estrutura, e leia seus dados da forma como eles deveriam ser lidos.