JSON
Formato de texto para troca de dados entre sistemas, escrito em pares de chave e valor e adotado como padrão pela maioria das APIs da web.
Também conhecido como: o que é json · arquivo json · formato json · json exemplo
Testar o CRPRO grátis por 7 diasJSON (JavaScript Object Notation) é um formato de texto para troca de dados entre sistemas, escrito em pares de chave e valor. É o que praticamente toda API moderna devolve e o que quase todo webhook entrega na sua porta.
A estrutura
{
"evento": "mensagem_recebida",
"contato": {
"nome": "Ana Souza",
"telefone": "5531999998888"
},
"etiquetas": ["lead quente", "instagram"],
"respondida": false
}
Chaves {} guardam objetos; colchetes [] guardam listas; texto vai entre aspas duplas; número, true, false e null vão sem aspas. Objetos podem conter outros objetos — é essa capacidade de aninhar que o CSV não tem.
JSON ou CSV
| JSON | CSV | |
|---|---|---|
| Estrutura | aninhada, hierárquica | tabela plana |
| Tipos | texto, número, booleano, nulo | tudo é texto |
| Leitura humana | razoável | boa |
| Uso típico | API, webhook, configuração | importação e exportação de listas |
Um contato com três telefones e cinco etiquetas cabe naturalmente em JSON; em CSV, vira coluna repetida ou campo com separador dentro do campo.
Os erros que quebram um JSON
Vírgula sobrando antes de fechar uma chave ou colchete, aspas simples no lugar das duplas, comentário (JSON não aceita) e chave sem aspas. Um caractere errado invalida o arquivo inteiro — não existe "meio JSON". Antes de abrir chamado com o fornecedor, cole o conteúdo em um validador.
JSON válido não significa dado certo
O formato garante sintaxe, não conteúdo. Telefone sem DDI, data em formato brasileiro onde se esperava ISO 8601 (2026-08-01T14:30:00Z) e campo obrigatório ausente passam pela validação de JSON e quebram na integração. Quem define o que é válido é a documentação da API, não o interpretador do formato.
Perguntas frequentes
O que é um arquivo JSON?
É um arquivo de texto que organiza dados em pares de chave e valor, legível tanto por pessoas quanto por máquinas. Ele permite estruturas aninhadas, como um contato que contém uma lista de etiquetas dentro. É o formato mais usado hoje para troca de dados entre sistemas.
Para que serve o JSON?
Serve para dois sistemas trocarem dados com estrutura definida: a resposta de uma API, o corpo de um webhook, um arquivo de configuração. Ele venceu porque é simples de ler, leve de trafegar e suportado por qualquer linguagem de programação. Quem integra sistemas convive com JSON diariamente.
Como abrir um arquivo JSON?
Qualquer editor de texto abre, incluindo o bloco de notas. Para ler com conforto, use um visualizador que formate e recolha os blocos, como um editor de código ou uma extensão de navegador. Evite abrir no Word, que pode inserir caracteres e corromper o arquivo.
Qual a diferença entre JSON e XML?
Os dois representam dados estruturados, mas o XML usa etiquetas de abertura e fechamento e ocupa bem mais espaço. O JSON é mais enxuto e mais direto de converter em objeto na maioria das linguagens. APIs novas nascem em JSON; XML sobrevive em sistemas mais antigos e em integrações fiscais.
Páginas relacionadas
Termos relacionados no glossário
API REST
Estilo de arquitetura de API que usa os métodos e códigos do próprio HTTP para operar sobre recursos identificados por URL, sem guardar estado entre chamadas.
CSV
Arquivo de texto puro em que cada linha representa um registro e os campos são separados por um caractere, quase sempre vírgula ou ponto e vírgula.
API
Interface que permite a dois sistemas trocarem dados e comandos entre si, sem que um precise conhecer o funcionamento interno do outro.