Módulo 7 - Trabalhando com JSON

O que é JSON e por que ele está em todo lugar

9 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 01/07/2026

O que você vai aprender

  • Entender o que é JSON e para que serve na troca de dados.
  • Reconhecer a semelhança entre JSON e dicionários e listas do Python.
  • Identificar onde o JSON aparece: APIs, configuração e arquivos.
  • Ler um trecho de JSON e saber o que cada parte representa.

O que é JSON, na prática

Imagine que dois programas precisam conversar. Um site em Python quer receber a previsão do tempo de um serviço escrito em outra linguagem. Como um manda os dados e o outro entende? A resposta, na maioria esmagadora dos casos, é JSON. Ele é um formato de texto simples, combinado por todo mundo, que representa dados de forma que qualquer linguagem consegue ler e escrever. É o idioma comum da troca de dados na internet.

A boa notícia para quem vem do Python é que o JSON vai parecer estranhamente conhecido. Um objeto JSON, com chaves e valores entre chaves, é a cara de um dicionário. Uma lista JSON, com itens entre colchetes, é a cara de uma lista do Python. Números são números, textos ficam entre aspas. Você já pensa nessas estruturas há semanas; agora só aprende a versão em texto delas. Veja um exemplo de JSON que descreve uma pessoa.

{
  "nome": "Ana Beatriz",
  "idade": 29,
  "assinante": true,
  "cidade": "São Paulo",
  "cursos": ["Python básico", "Python intermediário"],
  "telefone": null
}

Um objeto JSON: pares de chave e valor, com texto, número, booleano, lista e nulo.

Parecido com Python, com pequenas diferenças

A semelhança com o Python é real, mas há detalhes que mudam. No JSON, o texto sempre usa aspas duplas, nunca simples. Os valores de verdadeiro e falso se escrevem true e false, em minúsculas, e o nulo é null, não None. E o JSON não tem tuplas nem conjuntos: só objetos, listas, textos, números, booleanos e nulo. Guardar essas diferenças evita a maioria dos tropeços quando você começa a converter dados nas próximas aulas.

No Python (na memória)

  • Dicionário: {"nome": "Ana"}
  • Lista: [1, 2, 3]
  • Booleano: True e False
  • Ausência de valor: None

Em JSON (como texto)

  • Objeto: {"nome": "Ana"}
  • Array: [1, 2, 3]
  • Booleano: true e false
  • Ausência de valor: null

Repare que a estrutura é quase idêntica; muda a grafia de alguns valores. Por isso o Python facilita tanto o trabalho com JSON: existe um módulo pronto, chamado json, que já vem com a linguagem e cuida dessa tradução para você. Você não escreve as aspas na mão nem se preocupa com true virando True. O módulo faz a ponte nos dois sentidos, e as próximas aulas mostram exatamente como. Por ora, o importante é reconhecer o formato quando o encontrar.

Onde você vai encontrar JSON

JSON não é um assunto acadêmico; ele está no seu caminho o tempo todo. Quando um aplicativo de celular busca dados de um servidor, quase sempre a resposta chega em JSON. Quando um programa guarda suas preferências, muitas vezes salva um arquivo JSON. Quando dois sistemas de empresas trocam pedidos, notas ou cadastros, o pacote costuma ser JSON. Aprender esse formato abre a porta para consumir serviços da web e para gravar dados de forma organizada.

Onde apareceExemplo concretoPor que JSON
APIs da webCotação do dólar, previsão do tempo, CEPFormato universal que toda linguagem lê
ConfiguraçãoAjustes de um programa ou editorTexto simples, fácil de editar e versionar
Arquivos de dadosCatálogo de produtos, lista de contatosEstrutura clara e legível por humanos
Troca entre sistemasPedidos, cadastros, integraçõesCombinado independente de linguagem

Quatro lugares onde o JSON aparece no dia a dia de quem programa.

Uma qualidade que ajuda muito: JSON é legível por gente, não só por máquina. Você abre um arquivo JSON em qualquer editor de texto e consegue ler o que está lá, ao contrário de formatos binários. Isso torna o depuração mais fácil e ajuda a confiar no que o programa está gravando ou recebendo. Com a ideia do formato firmada, a próxima aula parte para a ação: transformar dados do Python em texto JSON com o módulo json.

Teste rápido

Qual afirmação sobre a relação entre JSON e Python está correta?

Perguntas frequentes

JSON é uma linguagem de programação?
Não. JSON é apenas um formato de texto para representar dados, não uma linguagem para escrever programas. Você não programa em JSON; você usa o JSON para guardar e trocar informações entre programas, que podem estar escritos em Python, JavaScript, Java ou qualquer outra linguagem.
Por que o nome tem JavaScript se eu uso em Python?
O formato nasceu a partir da forma como o JavaScript escreve objetos, por isso o nome JavaScript Object Notation. Mas ele se tornou tão prático que virou um padrão independente de linguagem. Hoje o Python, entre muitas outras, lê e escreve JSON sem nenhuma relação com o JavaScript.
Qual a diferença entre JSON e um dicionário do Python?
O dicionário vive na memória do seu programa e é feito de objetos Python. O JSON é texto: uma sequência de caracteres que representa esses dados. Um pode virar o outro, mas são coisas distintas. Você converte um dicionário em texto JSON para salvar ou enviar, e converte o texto de volta em dicionário para usar.
Preciso instalar alguma coisa para usar JSON no Python?
Não. O módulo json faz parte da biblioteca padrão, então já vem com o Python. Basta escrever import json no começo do arquivo e você tem tudo o que precisa para converter, ler e gravar. As próximas aulas mostram cada função desse módulo.
JSON serve para guardar qualquer tipo de dado do Python?
Serve para os tipos básicos: textos, números, booleanos, nulo, listas e dicionários. Tipos como tuplas viram listas, e conjuntos não têm equivalente direto. Objetos mais complexos, como datas, precisam ser convertidos para texto ou número antes. A aula sobre converter de Python para JSON detalha o que vira o quê.
JSON é seguro para abrir e ler?
O JSON é só texto de dados, sem código executável, o que o torna mais seguro que formatos que podem carregar comandos. Ainda assim, ao receber JSON de fontes externas, é bom validar o conteúdo antes de confiar nele, porque os valores em si podem estar errados ou fora do esperado.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.