Como formatar e validar JSON online

JSON (JavaScript Object Notation) é o formato de troca de dados mais usado no mundo. Criado por Douglas Crockford no início dos anos 2000, tornou-se o padrão de facto para APIs web, arquivos de configuração, bancos de dados NoSQL e armazenamento de dados estruturados.

Sua popularidade vem da simplicidade: legível por humanos, fácil de parsear para máquinas, leve em tamanho e suportado nativamente por JavaScript (a linguagem da web). Hoje, praticamente toda aplicação web moderna usa JSON para comunicação entre frontend e backend.

Mas essa simplicidade esconde uma armadilha: uma única vírgula mal colocada, uma aspas faltando ou um colchete não fechado invalida todo o arquivo. Por isso um bom formatador/validador JSON é uma ferramenta indispensável para todo desenvolvedor.

Vírgula final (trailing comma). O erro número 1. Em JavaScript, {"a": 1, "b": 2,} é válido. Em JSON estrito, essa vírgula final é proibida.

Aspas simples. JSON só aceita aspas duplas. {'name': 'John'} é inválido — deve ser {"name": "John"}.

Comentários. JSON não suporta comentários. Nem // nem /* */. Se precisar de comentários, use JSON5 ou JSONC.

Chaves sem aspas. {name: "John"} é JavaScript, não JSON. As chaves devem estar entre aspas duplas.

Caracteres de controle. Quebras de linha literais em strings são proibidas. Use \n em vez disso.

NaN, Infinity, undefined. Esses valores JavaScript não são valores JSON válidos. Use null em vez disso.

Passo 1: Cole seu JSON. Copie e cole seu JSON bruto no editor. O código é analisado automaticamente em tempo real.

Passo 2: Detecção de erros. Erros de sintaxe são destacados com mensagem explicativa. A ferramenta indica a linha e posição exata de cada erro.

Passo 3: Formatação automática. Clique em "Formatar" para indentar corretamente seu JSON. Escolha entre 2 ou 4 espaços de indentação.

Passo 4: Copie ou baixe. Recupere seu JSON formatado em um clique. Tudo acontece no seu navegador.

Nomeie suas chaves em camelCase. firstName em vez de first_name ou FirstName. É a convenção mais comum em APIs.

Use tipos consistentes. Se um campo é um número, não coloque entre aspas. "age": 25 e não "age": "25".

Evite níveis excessivos de aninhamento. Mais de 4-5 níveis de profundidade torna o JSON difícil de ler e manter.

Use arrays para listas. Mesmo que a lista contenha apenas um elemento, prefira um array por consistência.

Documente sua estrutura. Use JSON Schema para definir e validar a estrutura esperada dos seus dados.

APIs REST. JSON é o formato padrão de quase todas as APIs modernas. Respostas de API são JSON, corpos de requisições POST/PUT também.

Configuração. package.json (Node.js), tsconfig.json (TypeScript), .eslintrc.json — arquivos de configuração modernos usam massivamente JSON.

Bancos de dados. MongoDB armazena documentos BSON (JSON binário). PostgreSQL tem um tipo JSONB nativo. Firebase Realtime Database é essencialmente uma árvore JSON gigante.

Conversão. CSV ↔ JSON é uma das conversões mais comuns. Allplix oferece ferramentas dedicadas para essas conversões em ambas as direções.