Formatador e Validador de JSON para Feeds e APIs

O que é o Formatador de JSON?

O JSON (JavaScript Object Notation) é o formato de troca de dados mais usado em APIs e aplicações web. Minificado, ele é difícil de ler — esta ferramenta formata com indentação de 2 espaços para facilitar a leitura e depuração.

Como usar

Cole seu JSON no campo da esquerda e clique em Formatar para aplicar indentação legível, ou em Minificar para compactar e reduzir o tamanho. Se o JSON tiver erros de sintaxe, a mensagem de erro aparecerá à direita indicando a posição do problema.

Validação de erros

A validação usa JSON.parse() nativo do navegador — o mesmo motor que qualquer API JavaScript usa. Erros comuns incluem aspas simples no lugar de duplas, vírgula após o último item, e chaves/colchetes não fechados.

Quando usar e quando não usar

Use para ler uma resposta de API que chegou em linha única, para achar a vírgula que derrubou o feed de produtos e para minificar um trecho antes de colar em um campo que não aceita quebra de linha. É o primeiro teste quando o marketplace responde apenas "arquivo inválido".

A ferramenta valida sintaxe, não conteúdo. Um JSON perfeito aqui ainda pode ser recusado pelo Merchant Center por falta de um campo obrigatório ou por preço em formato de texto; essa conferência é feita contra a especificação de cada plataforma. Arquivos de dezenas de megabytes também não são o caso de uso: colados em um campo de texto, deixam a aba lenta. Para esses, prefira uma ferramenta de linha de comando como o jq.

Exemplo: o erro e a formatação

Trecho de feed com a vírgula sobrando depois do último campo, o erro mais comum em JSON montado por concatenação:

{"sku": "7891000100103", "preco": 21.98,}

Ao clicar em Formatar, o Chrome devolve:

Erro de sintaxe: Expected double-quoted property name in JSON at position 40 (line 1 column 41)

A posição 40 é exatamente o } que veio depois da vírgula: o parser esperava o nome de mais uma propriedade. A mensagem vem do motor JavaScript do navegador, em inglês, e muda de redação entre Chrome, Firefox e Safari; a indicação de linha e coluna depende dessa versão.

Com a vírgula removida e um bloco de estoque acrescentado, a entrada {"sku":"7891000100103","preco":21.98,"estoque":{"loja_12":40,"cd":1200}} sai assim:

{
  "sku": "7891000100103",
  "preco": 21.98,
  "estoque": {
    "loja_12": 40,
    "cd": 1200
  }
}

O que acontece por baixo

O texto é lido com JSON.parse, o parser nativo do navegador, que segue a especificação estrita do formato: chaves e textos entre aspas duplas, nenhuma vírgula no fim de lista, nenhum comentário. Se a leitura der certo, o objeto é escrito de volta com JSON.stringify, com recuo de dois espaços para Formatar e sem espaço algum para Minificar.

Por ser uma releitura e não uma simples troca de espaços, o resultado normaliza alguns detalhes. O número 21.90 sai como 21.9. Se a mesma chave aparece duas vezes no objeto, só o último valor sobrevive. Chaves que são números inteiros, como "10" e "2", vão para o início do objeto em ordem crescente. E números inteiros acima de 9.007.199.254.740.991 perdem precisão: 12345678901234567890 vira 12345678901234567000.

Limitações

• Valida apenas sintaxe; não há validação contra JSON Schema nem contra a especificação de feed de nenhuma plataforma.
• Não aceita JSON5 nem variantes com comentários ou aspas simples.
• IDs numéricos muito longos perdem os últimos dígitos na saída. Se o sistema de origem manda pedido ou código longo como número, confira no original.
• O recuo é fixo em dois espaços e a ordem das chaves inteiras muda, como descrito acima.
• Arquivos grandes deixam a aba lenta, porque tudo é processado na memória do navegador.

Privacidade

O JSON não é enviado ao servidor. Isso importa porque resposta de API costuma trazer token, e-mail e CPF de cliente: aqui o processamento é local e o conteúdo desaparece ao fechar a página. Mesmo assim, apague credenciais do trecho antes de compartilhar a tela ou o resultado.

Para continuar

Como Usar o Formatador de JSON para Debugar APIs de E-commerce segue um incidente do erro à correção, e JSON em Feeds de Produto trata da estrutura do feed entre ERP e marketplace. Quando o dado vem de planilha, o Conversor CSV ↔ JSON faz a ponte; se o payload chega codificado, o Base64 Encoder/Decoder revela o conteúdo antes da formatação.