Introdução ao tratamento de APIs

As APIs (interfaces de programação de aplicações) permitem que as aplicações se comuniquem entre si. A biblioteca requests do Python facilita a interação com APIs, permitindo enviar requisições HTTP e tratar respostas.

Nesta lição, você aprenderá a usar a biblioteca requests para enviar requisições a APIs e processar respostas.

Instalação do requests

Para instalar a biblioteca requests, use o seguinte comando no terminal:

pip install requests

Depois de instalada, você poderá importá-la nos seus scripts Python:

# Importing requests
import requests

print("Requests library imported successfully")

Enviando uma requisição GET

O método GET é usado para recuperar dados de uma API. Use a função requests.get() para enviar uma requisição GET:

# Sending a GET request
import requests

response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
print(response.json())  # Outputs the JSON response

Enviando uma requisição POST

O método POST é usado para enviar dados a uma API. Use a função requests.post():

# Sending a POST request
import requests

payload = {"title": "foo", "body": "bar", "userId": 1}
response = requests.post("https://jsonplaceholder.typicode.com/posts", json=payload)
print(response.json())  # Outputs the response

Tratando respostas

A biblioteca requests oferece vários atributos para tratar respostas, como:

• response.status_code: código de status HTTP.
• response.json(): dados JSON da resposta.
• response.text: conteúdo bruto da resposta.

# Handling responses
response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Failed with status code:", response.status_code)

Adicionando parâmetros de consulta

Você pode passar parâmetros de consulta para APIs usando o argumento params em uma requisição GET:

# Adding query parameters
params = {"userId": 1}
response = requests.get("https://jsonplaceholder.typicode.com/posts", params=params)
print(response.json())

Adicionando cabeçalhos

Os cabeçalhos permitem enviar informações adicionais, como chaves de API ou tipos de conteúdo, com as suas requisições:

# Adding headers
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://jsonplaceholder.typicode.com/posts", headers=headers)
print(response.status_code)

Tratando erros

A biblioteca requests oferece tratamento integrado de exceções para erros relacionados à rede:

# Handling errors
try:
    response = requests.get("https://jsonplaceholder.typicode.com/invalid")
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    print("HTTP error occurred:", err)
except requests.exceptions.RequestException as err:
    print("Request error occurred:", err)

Erros comuns com requests

Veja alguns erros que devem ser evitados:

• Não tratar erros HTTP com response.raise_for_status().
• Inserir diretamente no código informações sensíveis, como chaves de API.
• Esquecer de especificar o método HTTP correto, como GET ou POST.

O que aprendemos?

Nesta lição, você aprendeu:

• Como instalar e importar a biblioteca requests.
• Como enviar requisições GET e POST para APIs.
• Como tratar respostas, adicionar parâmetros de consulta e cabeçalhos e lidar com erros.

Muito bem! Vamos passar ao próximo tópico.