Como usar a ferramenta Formatador de JSON
- Cole ou abra seu JSONCole o JSON de uma resposta de API, log ou configuração, ou abra um arquivo .json do seu computador.
- Escolha a formataçãoEscolha 2 espaços, 4 espaços ou tabulação e, se quiser, ordene as chaves em ordem alfabética.
- Formate, minifique ou valideClique em “Formatar / Embelezar” para uma saída legível, “Minificar” para o menor tamanho ou “Só validar” para checar a sintaxe.
- Copie ou baixeCopie o resultado para a área de transferência ou baixe como arquivo .json.
Por que desenvolvedores usam este formatador
- Erros localizadosJSON inválido mostra a linha e a coluna do problema e uma dica para erros comuns, como aspas simples ou vírgulas sobrando.
- Embelezar e minificarAlterne com um clique entre indentação legível e saída compacta numa só linha.
- Ordenar chavesChaves em ordem alfabética facilitam comparar dois JSON numa ferramenta de diff.
- Privado por padrãoA análise usa o motor JSON do próprio navegador. Tokens, dados de clientes e chaves de API nunca saem da sua máquina.
O que é JSON?
JSON (JavaScript Object Notation) é um formato de texto leve para dados estruturados. É a forma padrão de as APIs web enviarem dados e aparece em arquivos de configuração, bancos como o MongoDB e na troca de dados entre quase todas as linguagens de programação. Ele é formado por objetos ({ }), arrays ([ ]), strings, números, booleanos (true/false) e null.
As APIs costumam devolver o JSON minificado em uma linha só, para economizar banda. Isso é ótimo para máquinas, mas difícil para pessoas. Um formatador adiciona quebras de linha e recuo para você enxergar a estrutura de relance.
Erros de sintaxe mais comuns
JSON é mais rígido que JavaScript. Estes são os erros que nosso validador mais encontra:
- Aspas simples. Strings e chaves usam aspas duplas:
{"name": "Ana"}, não{'name': 'Ana'}. - Vírgula no final. Uma vírgula depois do último item, como em
[1, 2, 3,], não é permitida. - Chaves sem aspas.
{name: "Ana"}é JavaScript válido, mas JSON inválido. - Comentários. JSON padrão não tem comentários. Remova as linhas
//e/* */. - Valores especiais. undefined, NaN e Infinity não são válidos. Use null ou um número.
- Caracteres sem escape. Quebras de linha e aspas duplas dentro de uma string precisam ser escritas como
\ne\".
Formatar ou minificar?
Use JSON com recuo enquanto desenvolve, analisa respostas de API ou envia arquivos de configuração para o Git: arquivos legíveis geram diferenças mais claras. Use JSON minificado para enviar pela rede ou guardar em produção, onde cada byte conta. Minificar só tira espaços; os dados não mudam.
É seguro colar respostas de API aqui?
Sim. Muitos formatadores on-line mandam seus dados para um servidor. Este não: a formatação e a validação acontecem dentro do navegador, com o mesmo motor JSON que o navegador usa em qualquer site. Você pode até desligar a internet depois de abrir a página e a ferramenta continua funcionando. Mesmo assim, é bom hábito tirar senhas e chaves de API reais antes de compartilhar um JSON.