Usando um pacote externo na prática

Do pip ao import

Instalar o requests foi só a preparação. Para usá-lo, você o traz para o programa com import requests, do mesmo jeito que importa um módulo da biblioteca padrão. A diferença é que o requests não vem com o Python: ele só existe porque você o instalou naquela despensa. Por isso o import só funciona com o ambiente virtual ativo, onde o pacote está. Se você tentar importar o requests fora do ambiente, o Python reclama que não encontrou o módulo, e a mensagem é justamente essa pista.

Para o exemplo, vamos conversar com uma API pública de teste. Existem serviços gratuitos feitos para quem está aprendendo, que devolvem dados de brincadeira em JSON, sem cobrar nada e sem pedir cadastro. Um pedido a esse tipo de API é seguro para praticar. A ideia é fazer o menor exemplo útil possível: pedir um recurso, olhar se o pedido deu certo e ler o que voltou. Nada de servidores, senhas ou dados de verdade. Só o essencial para ver um pacote externo funcionando de ponta a ponta.

O pedido e o código de status

A operação mais comum na web é o GET: pedir um recurso e receber os dados dele. Com o requests, isso é uma linha: você chama requests.get com o endereço e guarda o resultado numa variável, aqui chamada resposta. Antes de mexer nos dados, cheque o código de status, que fica em resposta.status_code. O número 200 quer dizer que deu tudo certo. Se vier 404, o recurso não existe; se vier 500, o problema é do servidor. Conferir isso antes evita tratar como dado válido uma resposta que, na verdade, foi um erro.

import requests

url = "https://jsonplaceholder.typicode.com/todos/1"
resposta = requests.get(url, timeout=10)

print("Status:", resposta.status_code)
if resposta.status_code == 200:
    print("Pedido bem-sucedido.")
else:
    print("Algo deu errado no pedido.")

Um GET a uma API pública de teste, checando o código de status antes de seguir.

Repare no timeout=10 no pedido. Ele diz ao requests para desistir se o servidor não responder em dez segundos, em vez de esperar para sempre. É um hábito saudável: pedidos de rede podem travar, e um limite de tempo evita que o seu programa fique pendurado. Esse é o tipo de detalhe que separa um script frágil de um código cuidadoso. A checagem do status e o timeout juntos já deixam a requisição bem mais robusta do que simplesmente confiar que tudo vai dar certo.

Lendo a resposta em JSON

APIs da web costumam devolver os dados em JSON, um formato de texto que representa objetos e listas. O requests facilita a leitura: o método resposta.json() converte esse texto direto em dados Python, normalmente um dicionário ou uma lista de dicionários. A partir daí, você trabalha como já sabe, acessando valores por chave. No exemplo, a API de teste devolve um pequeno objeto com campos como título e estado de conclusão, e você lê cada um pelo nome.

import requests

url = "https://jsonplaceholder.typicode.com/todos/1"
resposta = requests.get(url, timeout=10)

if resposta.status_code == 200:
    dados = resposta.json()   # vira um dicionario Python
    print("Titulo:", dados["title"])
    print("Concluida?", dados["completed"])
else:
    print("Nao foi possivel obter os dados. Status:", resposta.status_code)

resposta.json() transforma o corpo da resposta em um dicionário Python.

Junte as peças e o exemplo conta uma história completa: você importou um pacote que instalou, pediu um recurso a uma API, verificou se o pedido deu certo e transformou a resposta em dados que o Python entende. É pouco código, mas mostra o valor do ecossistema. Sem o requests, fazer um pedido HTTP à mão dá bem mais trabalho. Com ele, cabe em poucas linhas legíveis. Esse é o retorno de aprender ambientes virtuais e pip: você passa a usar o trabalho de milhares de pessoas com segurança e organização.