Consumir una API con Bearer Token

Oct 13, 2025 by pynkocean.com 82 views

Introducción

En el mundo de la programación, es común que las aplicaciones web requieran autenticación para proteger sus recursos y datos. Una forma común de autenticación es mediante el uso de tokens de acceso, como el Bearer Token. En este artículo, exploraremos cómo consumir una API protegida con Bearer Token utilizando Python y la biblioteca requests.

¿Qué es un Bearer Token?

Un Bearer Token es un token de acceso que se utiliza para autenticar a un usuario en una aplicación web. Este token se emite por un servidor de autenticación y se utiliza para autorizar solicitudes a un recurso protegido. El Bearer Token se envía en la cabecera de autorización de la solicitud HTTP, junto con el prefijo "Bearer".

Requisitos previos

Para seguir con este artículo, necesitarás tener instalado Python y la biblioteca requests. Si no tienes instalada la biblioteca requests, puedes instalarla utilizando pip:

pip install requests

Consumir una API con Bearer Token

Para consumir una API protegida con Bearer Token, necesitarás seguir los siguientes pasos:

1. Obtener el Bearer Token

Primero, debes obtener el Bearer Token de la API. Esto se puede hacer mediante una solicitud de autenticación a la API. La forma en que se obtiene el token puede variar dependiendo de la API, pero generalmente se envía un cuerpo de solicitud con los datos de autenticación y se recibe un token de respuesta.

2. Enviar el Bearer Token en la cabecera de autorización

Una vez que tengas el Bearer Token, debes enviarlo en la cabecera de autorización de la solicitud HTTP. Esto se puede hacer utilizando la biblioteca requests en Python.

3. Realizar la solicitud a la API

Finalmente, debes realizar la solicitud a la API utilizando la biblioteca requests. La solicitud debe incluir la cabecera de autorización con el Bearer Token.

Ejemplo de código

A continuación, te muestro un ejemplo de código que muestra cómo consumir una API protegida con Bearer Token utilizando Python y la biblioteca requests:

import requests

# URL de la API
url = "https://api.example.com/data"

# Bearer Token
token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaGFuIjoiMjMwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

# Cabecera de autorización
headers = {
    "Authorization": f"Bearer {token}"
}

# Realizar la solicitud a la API
response = requests.get(url, headers=headers)

# Verificar el estado de la respuesta
if response.status_code == 200:
    # Procesar la respuesta
    data = response.json()
    print(data)
else:
    # Manejar el error
    print(f"Error: {response.status_code}")

Conclusión

En este artículo, hemos visto cómo consumir una API protegida con Bearer Token utilizando Python y la biblioteca requests. La autenticación con Bearer Token es una forma común de proteger recursos en la web, y la biblioteca requests proporciona una forma fácil de realizar solicitudes a APIs protegidas con este método.

Preguntas frecuentes

¿Cómo obtengo el Bearer Token de la API?

La forma en que se obtiene el token puede variar dependiendo de la API, pero generalmente se envía un cuerpo de solicitud con los datos de autenticación y se recibe un token de respuesta.

¿Cómo envío el Bearer Token en la cabecera de autorización?

Puedes enviar el token en la cabecera de autorización utilizando la biblioteca requests en Python.

¿Cómo realizo la solicitud a la API?

Puedes realizar la solicitud a la API utilizando la biblioteca requests en Python.

Recursos adicionales

Documentación de la biblioteca requests: https://requests.readthedocs.io/en/master/
Guía de autenticación con Bearer Token en la API de ejemplo: https://api.example.com/docs/auth

Licencia

¿Qué es un Bearer Token?

¿Cómo obtengo el Bearer Token de la API?

La forma en que se obtiene el token puede variar dependiendo de la API, pero generalmente se envía un cuerpo de solicitud con los datos de autenticación y se recibe un token de respuesta.

¿Cómo envío el Bearer Token en la cabecera de autorización?

Puedes enviar el token en la cabecera de autorización utilizando la biblioteca requests en Python. Por ejemplo:

headers = {
    "Authorization": f"Bearer {token}"
}

¿Cómo realizo la solicitud a la API?

Puedes realizar la solicitud a la API utilizando la biblioteca requests en Python. Por ejemplo:

response = requests.get(url, headers=headers)

¿Qué pasa si el Bearer Token es inválido o expirado?

Si el Bearer Token es inválido o expirado, la API puede devolver un código de estado de error (por ejemplo, 401 Unauthorized). En este caso, debes obtener un nuevo Bearer Token y volver a realizar la solicitud.

¿Cómo manejo errores en la solicitud a la API?

Puedes manejar errores en la solicitud a la API utilizando el método try/except en Python. Por ejemplo:

try:
    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        # Procesar la respuesta
        data = response.json()
        print(data)
    else:
        # Manejar el error
        print(f"Error: {response.status_code}")
except requests.exceptions.RequestException as e:
    # Manejar el error de solicitud
    print(f"Error de solicitud: {e}")

¿Qué es un Refresh Token?

Un Refresh Token es un token que se utiliza para obtener un nuevo Bearer Token cuando el anterior expira. El Refresh Token se envía en la cabecera de autorización de la solicitud de refresco.

¿Cómo utilizo un Refresh Token para obtener un nuevo Bearer Token?

Puedes utilizar un Refresh Token para obtener un nuevo Bearer Token enviando una solicitud de refresco a la API. Por ejemplo:

refresh_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaGFuIjoiMjMwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

headers = {
    "Authorization": f"Bearer {refresh_token}"
}

response = requests.post(url, headers=headers)
if response.status_code == 200:
    # Procesar la respuesta
    new_token = response.json()["token"]
    print(new_token)
else:
    # Manejar el error
    print(f"Error: {response.status_code}")

¿Qué es un Token de Acceso?

Un Token de Acceso es un token que se utiliza para acceder a un recurso protegido en la API. El Token de Acceso se envía en la cabecera de autorización de la solicitud.

¿Cómo utilizo un Token de Acceso para acceder a un recurso protegido?

Puedes utilizar un Token de Acceso para acceder a un recurso protegido enviando una solicitud a la API con el Token de Acceso en la cabecera de autorización. Por ejemplo:

access_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaGFuIjoiMjMwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

headers = {
    "Authorization": f"Bearer {access_token}"
}

response = requests.get(url, headers=headers)
if response.status_code == 200:
    # Procesar la respuesta
    data = response.json()
    print(data)
else:
    # Manejar el error
    print(f"Error: {response.status_code}")

Conclusión

En este artículo, hemos visto algunas preguntas frecuentes sobre consumir una API con Bearer Token. Esperamos que esta información haya sido útil para ti. Si tienes alguna pregunta adicional, no dudes en preguntar.