Introdução ao uso de APIs

As APIs (interfaces de programação de aplicações) permitem que os aplicativos se comuniquem entre si. A biblioteca requests do Python facilita a interação com APIs por meio do envio de solicitações HTTP e do tratamento de respostas.

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

Instalando requests

Para instalar a biblioteca requests, use o comando a seguir no seu 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 solicitação GET

O método GET é usado para recuperar dados de uma API. Use a função requests.get() para enviar uma solicitaçã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 solicitaçã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

Lidando com respostas

A biblioteca requests fornece vários atributos para lidar com respostas, como:

• response.status_code: código de status HTTP.
• response.json(): dados da resposta em JSON.
• 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 solicitaçã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 suas solicitações:

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

Lidando com erros

A biblioteca requests fornece 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 ao usar requests

Veja alguns erros que você deve evitar:

• Não tratar erros de HTTP com response.raise_for_status().
• Inserir informações confidenciais diretamente no programa, como chaves de API.
• Esquecer-se de especificar o método HTTP correto (por exemplo, GET, POST).

O que aprendemos?

Nesta lição, você aprendeu:

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

Excelente trabalho! Vamos passar ao próximo tópico.