Introducción a la gestión de APIs

Las APIs (interfaces de programación de aplicaciones) permiten que las aplicaciones se comuniquen entre sí. La biblioteca requests de Python facilita la interacción con las APIs mediante el envío de solicitudes HTTP y la gestión de respuestas.

En esta lección, aprenderá a usar la biblioteca requests para enviar solicitudes a APIs y procesar respuestas.

Instalar requests

Para instalar la biblioteca requests, use el siguiente comando en su terminal:

pip install requests

Una vez instalada, puede importarla en sus scripts de Python:

# Importing requests
import requests

print("Requests library imported successfully")

Enviar una solicitud GET

El método GET se utiliza para recuperar datos de una API. Use la función requests.get() para enviar una solicitud GET:

# Sending a GET request
import requests

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

Envío de una solicitud POST

El método POST se utiliza para enviar datos a una API. Utilice la función 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

Gestionar respuestas

La biblioteca requests proporciona varios atributos para gestionar las respuestas, como:

• response.status_code: código de estado HTTP.
• response.json(): datos de la respuesta en formato JSON.
• response.text: contenido sin procesar de la respuesta.

# 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)

Añadir parámetros de consulta

Puede pasar parámetros de consulta a las APIs mediante el argumento params en una solicitud GET:

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

Añadir encabezados

Los encabezados permiten enviar información adicional, como claves de API o tipos de contenido, junto con sus solicitudes:

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

Gestionar errores

La biblioteca requests proporciona gestión integrada de excepciones para errores relacionados con la red:

# 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)

Errores comunes con requests

Estos son algunos errores que debe evitar:

• No gestionar los errores HTTP con response.raise_for_status().
• Incluir directamente en el script información confidencial, como las claves de API.
• Olvidar especificar el método HTTP correcto (p. ej., GET o POST).

¿Qué hemos aprendido?

En esta lección, ha aprendido:

• Cómo instalar e importar la biblioteca requests.
• Cómo enviar solicitudes GET y POST a las APIs.
• Cómo gestionar respuestas, añadir parámetros de consulta y encabezados, y gestionar errores.

¡Excelente trabajo! Pasemos al siguiente tema.