A biblioteca Requests em Python permite que você envie requisições HTTP de forma simples. Você pode acessar dados de APIs, baixar informações de sites ou automatizar tarefas que dependem da internet. Ela é muito usada porque tem uma sintaxe clara e funciona bem até para quem está começando na programação.
Neste artigo, você vai aprender como instalar, usar e aplicar a biblioteca Requests em diversos cenários reais. Também verá exemplos práticos e dicas importantes para evitar erros comuns. O texto foi escrito em linguagem simples, ideal para quem ainda está no início da jornada com Python para iniciantes.
O que é a biblioteca Requests
A biblioteca Requests facilita a comunicação entre o seu programa e a internet. Ela envia requisições do tipo GET, POST, PUT e DELETE para servidores web. Isso permite buscar dados, enviar informações, atualizar registros em APIs e muito mais.
Sem o Requests, você teria que usar módulos nativos do Python que são mais complexos. Com ele, o código fica limpo e direto. Por isso, muitos iniciantes aprendem Requests logo depois de entender conceitos básicos como variáveis, entrada e saída de dados e tipos de dados.
Como instalar a biblioteca Requests
A instalação é muito simples. Você só precisa rodar o comando abaixo no terminal, assim como mostrado no artigo sobre como instalar bibliotecas no Python:
pip install requestsDepois disso, já pode importar a biblioteca no seu código:
import requestsComo fazer uma requisição GET
A requisição GET é usada para buscar dados de um servidor. É a mais comum e aparece em quase todos os projetos que envolvem APIs. Veja um exemplo simples:
import requests
url = "https://jsonplaceholder.typicode.com/posts/1"
resposta = requests.get(url)
print(resposta.json())Neste exemplo, o Requests acessa uma API pública e retorna dados em formato JSON. Você pode usar esse mesmo padrão para consumir qualquer outra API.
Se você já estudou dicionários em Python, vai perceber que trabalhar com JSON é muito intuitivo.
Verificando status da resposta
Toda resposta HTTP tem um código de status. Os mais comuns são:
- 200: sucesso
- 404: não encontrado
- 500: erro no servidor
Você pode verificar assim:
print(resposta.status_code)Também pode tratar erros para evitar que seu programa pare. A biblioteca Requests oferece métodos como raise_for_status().
Como enviar dados com POST
A requisição POST envia informações para um servidor. É muito usada em formulários, login e criação de registros.
import requests
url = "https://jsonplaceholder.typicode.com/posts"
dados = {"title": "Meu Post", "body": "Conteúdo", "userId": 1}
resposta = requests.post(url, json=dados)
print(resposta.json())Quando você usa APIs reais, verá que o método POST é essencial em projetos de automação como mostrado no artigo sobre automatizando tarefas com Python.
Como trabalhar com cabeçalhos e parâmetros
Muitas APIs exigem cabeçalhos especiais como chaves de autenticação. Veja um exemplo:
headers = {"Authorization": "Bearer MINHA_CHAVE"}
requests.get(url, headers=headers)Parâmetros também são comuns:
params = {"page": 2, "limit": 20}
requests.get(url, params=params)Isso ajuda em atividades como web scraping com Requests, que dependem do envio correto de parâmetros para a página.
Como lidar com erros e exceções
Erros acontecem por causa da internet lenta, URLs inválidas ou APIs que estão temporariamente fora do ar. Por isso, é importante tratar exceções.
import requests
try:
resposta = requests.get(url, timeout=5)
resposta.raise_for_status()
except requests.exceptions.RequestException as erro:
print("Ocorreu um erro:", erro)Esse padrão evita que seu programa trave e garante uma melhor experiência de uso.
Quando usar a biblioteca Requests
Você pode usar o Requests em várias situações:
- Criar automações que dependem de dados online
- Acessar APIs públicas e privadas
- Conectar Python com sistemas externos
- Baixar arquivos e salvar no computador
- Criar bots que interagem com serviços da internet
Se você já estudou módulos e pacotes no Python, sabe que Requests é uma ferramenta essencial em qualquer projeto que envolva comunicação com servidores.
Exemplos práticos do mundo real
1. Consultar clima em uma API
Você pode usar Requests para buscar dados de clima em serviços como OpenWeather. Depois, pode exibir os resultados com uma mensagem simples no terminal.
2. Criar um robô que monitora preços
Basta consumir uma API de preços e verificar se houve mudança. Esse tipo de tarefa combina bem com estruturas de decisão e loops como for e while.
3. Baixar arquivos automaticamente
Requests permite baixar PDFs, imagens e vídeos sem precisar abrir o navegador.
Boas práticas ao usar Requests
- Sempre trate erros com try e except
- Use timeout para evitar travamentos
- Verifique o status da resposta
- Leia a documentação da API antes de programar
- Não envie dados sensíveis sem criptografia
Conclusão
A biblioteca Requests em Python é uma ferramenta essencial para qualquer pessoa que quer trabalhar com APIs, automações e sistemas que dependem da internet. Ela é simples, direta e fácil de aprender, o que a torna perfeita para quem está começando na programação.
Perguntas Frequentes (FAQ)
1. O que é a biblioteca Requests?
É uma biblioteca que envia requisições HTTP de forma simples no Python.
2. Como instalar Requests?
Use o comando pip install requests no terminal.
3. Requests funciona para qualquer API?
Sim, desde que a API aceite requisições HTTP.
4. Como faço uma requisição GET?
Use requests.get(url) e leia a resposta.
5. Consigo enviar dados com Requests?
Sim, usando o método POST.
6. Requests é seguro?
Sim, mas depende da API e da forma como você envia dados.
7. Preciso usar headers?
Apenas quando a API exige autenticação ou configurações extras.
8. Como tratar erros no Requests?
Use try e except para capturar exceções.
9. Posso baixar arquivos com Requests?
Sim, lendo o conteúdo binário da resposta.
10. O Requests funciona offline?
Não, ele depende da internet para enviar requisições.
11. Como enviar parâmetros na URL?
Use o argumento params no requests.get.
12. Requests funciona com JSON?
Sim, basta usar resposta.json().
