Ir para o conteúdo principal

Como formatar JSON online: guia completo para devs (validação, minify, conversão)

JSON é onipresente em APIs modernas — formatá-lo, validá-lo e convertê-lo são operações diárias. Guia técnico cobrindo formatação, minify, conversão para CSV/XML, e ferramentas que processam local.

Quorify Editorial10 de maio de 20267 min de leitura

JSON (JavaScript Object Notation) é o formato dominante de troca de dados em APIs modernas — REST, GraphQL responses, webhooks, configs, JWTs. Devs olham e manipulam JSON dezenas de vezes por dia. Mas JSON cru de uma resposta API vem MINIFICADO (uma única linha gigante) — impossível de ler. Este guia cobre as operações essenciais: formatar para leitura, validar sintaxe, minificar para envio, e converter entre JSON e outros formatos.

JSON formatado vs minificado: quando usar cada um

JSON minificado (uma linha sem espaços) é como APIs transmitem — economiza bytes. Exemplo: `{"id":1,"name":"Joao","items":[1,2,3]}`. Bom para network, ruim para humano.

JSON formatado (pretty-printed com indentação) é como você LÊ. Exemplo:

  • Para debug de API response: formate.
  • Para colar em código (request body de API): minifique (cabe em querystring ou body sem newlines).
  • Para versionar em Git: formate (diffs ficam legíveis).
  • Para transmitir via WebSocket ou caber em limite de payload: minifique.

Como formatar JSON em 5 segundos

Cole o JSON no JSON Formatter do Quorify, clique em 'Format'. Resultado:

  1. JSON com indentação (2 ou 4 espaços, configurável).
  2. Sintaxe colorida — facilita identificar tipos (string, number, boolean, array, object).
  3. Erros destacados com linha e coluna específicas (se sintaxe inválida).
  4. Botão Copy para colar no editor de código.

Validação de JSON: erros comuns e como descobrir

Os 5 erros de sintaxe JSON mais comuns que vemos em debug:

  1. Vírgula faltando entre items: `{"a": 1 "b": 2}` — falta vírgula após 1.
  2. Vírgula sobrando no final (trailing comma): `{"a": 1, "b": 2,}` — vírgula após 2 quebra. JSON estrito não permite.
  3. Aspas simples em vez de duplas: `{'a': 1}` — JSON SÓ aceita aspas duplas em chaves e strings. JavaScript aceita ambas, JSON não.
  4. Chave sem aspas: `{a: 1}` — chaves em JSON SEMPRE precisam de aspas. JS objeto literal aceita; JSON não.
  5. String não escapada: `{"text": "He said "hi""}` — aspas dentro de string precisam escape: `"He said \"hi\""`.

Minify para envio: quando e como

Minify remove TODO whitespace (espaços, quebras de linha, indentação). Resultado: economia de 20-60% em tamanho dependendo do JSON original.

Use minify quando:

  • Enviar em querystring de URL (limite 2048 chars na maioria dos browsers).
  • Enviar em body de webhook com limite de payload (alguns webhooks limitam a 64KB).
  • Configurar variável de ambiente (.env) que aceita só uma linha.
  • Embedar JSON em HTML/JS inline (evita newlines que quebram).

Converter JSON para outros formatos

JSON é onipresente em APIs, mas você frequentemente precisa converter para outros formatos:

JSON → CSV: para análise em Excel/Sheets. Use o Conversor JSON → CSV do Quorify — aceita arrays de objetos (formato comum), achata chaves aninhadas opcional, configura delimitador (',' ou ';' para Excel BR).

JSON → YAML: para configs (Kubernetes, Docker Compose, GitHub Actions). YAML é mais legível para humanos editando à mão.

JSON → XML: para integrar com APIs SOAP legadas. O reverso (XML para JSON) é mais comum — modernizar SOAP responses.

JSON em produção: validação no backend

Ferramenta web é boa para DEBUG. Em produção, valide JSON no seu backend antes de processar.

Node.js: `JSON.parse()` lança erro em JSON inválido. Sempre wrap em try/catch.

Python: `json.loads()` lança `json.JSONDecodeError`.

Go: `json.Unmarshal()` retorna error.

Para validação ESTRUTURAL (não só sintaxe), use schemas: JSON Schema (linguagem-agnóstica), Zod (TS), Pydantic (Python). Garante que campos obrigatórios existem e têm tipos corretos.

Performance: lidando com JSON gigante

JSON de algumas dezenas de MB já trava browser/editor de código. Estratégias:

  • Streaming parser (não carrega tudo em memória): use `oboe.js` no JS, `ijson` no Python.
  • JSONL (JSON Lines): cada linha é um objeto JSON independente. Útil para logs, exports de banco.
  • Truncar para debug: copie só os primeiros 1000 chars para inspeção visual.
  • Use jq na CLI: para JSON gigante, `jq '.field'` é muito mais rápido que ferramenta web.

Conclusão

JSON é commodity técnica em 2026 — todo dev manipula dezenas de vezes por dia. Para formatação, validação e conversão pontual, ferramenta web local (como o JSON Formatter do Quorify) é mais rápido que abrir VS Code, instalar extensão ou usar `jq` no terminal. Para conversões específicas, use os conversor JSON → CSV e XML → JSON. Para outras operações dev de debug, o Regex Tester e o JWT Decoder completam o kit essencial.

Use a ferramenta agora

Formatador JSON

Embeleze, valide e minimize seus objetos JSON rapidamente.

Abrir Formatador JSON

Ferramentas relacionadas