Formatador e Validador de JSON

Como formatar JSON

1. Cole o seu JSON na caixa de entrada, ou comece a digitar.
2. Escolha o tamanho da indentação (2 ou 4 espaços) se quiser algo diferente do padrão.
3. A saída formatada é atualizada ao vivo enquanto você digita, com qualquer erro de parse destacado.
4. Clique em Minificar se preferir a versão compacta em uma linha só.
5. Copie o resultado com o botão de copiar, ou selecione e copie manualmente.

Erros comuns de JSON que esta ferramenta pega

A maioria dos JSON inválidos falha por poucos motivos: uma vírgula sobrando depois do último item, aspas simples no lugar de aspas duplas, chaves sem aspas ou um caractere de controle perdido que veio junto no copiar e colar. O validador aponta a posição em que o parse falhou, que costuma ficar logo depois do erro de verdade.

Vale lembrar que JSON é mais rígido que objetos literais de JavaScript. Comentários, vírgulas finais e strings com aspas simples são válidos em JS, mas inválidos em JSON. Se você copiou um objeto do código-fonte, é bem provável que seja por isso que ele não valida.

O que o formatador JSON realmente faz

No fundo, a ferramenta faz três tarefas numa mesma tela: valida, formata e minifica. A validação faz o parse do seu texto com as mesmas regras de um parser JSON rígido e relata a primeira coisa que não estiver em conformidade. A formatação reemite os dados analisados com indentação e quebras de linha consistentes, deixando o aninhamento óbvio. A minificação reemite tudo com cada espaço e quebra de linha opcional removidos.

Como as três operações partem de um único parse da sua entrada, a saída é sempre uma representação fiel dos dados, e não uma substituição de texto no nível dos caracteres. Nunca há reordenação, os números mantêm o valor e as strings mantêm o conteúdo exato; só os espaços em branco entre os tokens mudam entre a visão formatada e a minificada.

Como ele roda inteiramente no seu navegador

Quando a página carrega, a lógica de formatação carrega junto, em JavaScript. A partir daí, cada tecla digitada é tratada no seu dispositivo: o texto da caixa é analisado e reserializado na memória, e o resultado é escrito direto de volta na área de saída. Não há nenhuma requisição a um servidor no meio, e é por isso que a saída aparece no instante em que você para de digitar, mesmo numa conexão lenta.

Um efeito colateral útil é que a ferramenta continua funcionando se a sua conexão cair depois que a página já carregou. Você não está chamando uma API para formatar JSON; o próprio navegador faz o parse. Quem cola payloads reais se importa com isso, porque significa que os dados fisicamente não podem ser interceptados a caminho de um serviço de formatação que não existe.

Privacidade ao colar payloads reais

O JSON com que você lida no dia a dia raramente é um dado de exemplo inofensivo. São respostas de API com registros de clientes, corpos de webhook com assinaturas, arquivos de configuração com strings de conexão ou dumps de depuração com bearer tokens ainda anexados. Colar isso numa ferramenta online que faz upload seria um vazamento de verdade — exatamente o risco que este formatador JSON foi feito para eliminar.

Nada do que você cola é transmitido, armazenado ou registrado. Não existe conta que possa vincular os dados a você, nem histórico do lado do servidor a ser intimado ou violado. Quando você fecha a aba, o conteúdo some da memória. Isso torna seguro validar e embelezar JSON sensível que você nunca teria permissão de enviar a terceiros.

Usos do dia a dia para desenvolvedores e analistas

A tarefa mais comum é tornar legível uma resposta de API ilegível: um serviço devolve uma longa linha minificada, você cola, e a estrutura aninhada vira algo que dá para escanear e depurar. Logo atrás vem conferir se aquele arquivo de configuração editado à mão, um manifesto de pacote ou um template de infraestrutura ainda faz parse antes de você commitar e disparar um deploy que falha.

É igualmente útil no sentido contrário. Quando você precisa colocar JSON numa variável de ambiente, num comando de shell, numa coluna de banco de dados ou num corpo de requisição de teste, minificar reduz tudo a uma única linha compacta. Analistas também usam a ferramenta para arrumar dados exportados antes de colá-los numa planilha ou num notebook para seguir o trabalho.

Dicas para trabalhar com JSON grande ou problemático

Se um documento se recusa a validar, trabalhe de cima para baixo: a posição relatada aponta logo depois da quebra, então confira o token imediatamente anterior em busca de uma vírgula faltando, um colchete não fechado ou uma aspa que nunca foi encerrada. Para dados muito aninhados, formate primeiro e depois use o realce de pares de colchetes do seu editor para confirmar que cada chave de abertura tem par.

Quando você só precisa de parte de um payload enorme, cole tudo, formate para tornar a estrutura visível e então copie apenas o objeto ou array que interessa e reformate esse trecho. Indentação de dois ou de quatro espaços é puramente estética; escolha a que combina com o arquivo em que você vai colar de volta, para manter os diffs limpos.

Ferramentas relacionadas no ConvertForever

Valores JSON costumam viajar embrulhados em outras codificações. Se um campo guarda um blob Base64, decodifique com a ferramenta Base64 para ver o texto por baixo; se guarda uma URL com codificação de porcentagem, o decodificador de URL a transforma de volta em algo legível. Um JWT que você encontra numa resposta é formado por três segmentos Base64url, e o segmento do meio é, ele próprio, JSON que você pode colar aqui para formatar.

Para trabalho de integridade, o gerador de hash produz uma impressão digital SHA-256 de um documento JSON, permitindo saber se dois payloads são idênticos byte a byte. Cada uma dessas ferramentas roda do lado do cliente da mesma forma centrada em privacidade, então você pode mover dados entre elas sem que nada saia do seu navegador.

Perguntas frequentes

Ferramentas relacionadas