Quique Ciria

Este es el primero de una serie de tres artículos donde mostraré cómo visualizo mis actividades de Strava en una tabla Notion. De momento, mi objetivo es visualizar mi promedio de kilómetros en bicicleta de los últimos 7 días naturales (la idea es que sea alrededor de los 150 km) para ver aproximadamente en que estado estoy a nivel físico.

Pero si es verdad, que una vez los datos de las actividades en Notion, ya podemos hacer lo que queramos con ellos, ya sea dentro del propio Notión, o utilizándolo como una base de datos.

Serán tres posts divididos en las siguientes partes:

API de Strava y obtención de datos de las actividades actual
Pintar los datos obtenidos de Strava en una tabla de Notion pendiente
Automatizar la sincronización con GitHub Action pendiente

1º Regístrate en la API de Strava

Necesitas registrar tu aplicación en Strava para obtener tus credenciales (client_id, client_secret y access_token) Para ello:

Ve a la página de desarrolladores de Strava e inicia sesión con tu cuenta.

Crea una nueva aplicación y toma nota de los siguientes datos:

∘ client_id

∘ client_secret

∘ access_token (Este lo obtendrás durante el proceso de autenticación).

Toma nota de los campos marcados en amarillo.

2º Autenticación de Strava

Strava usa 0Auth 2.0 para autenticarse. Para acceder a los datos de usuario, primero necesitas obtener un access_token

📌 Recuerda que en las URLs que pongo de ejemplo lo que tienes que sustituir con tus datos es lo marcado en mayúsculas.

Conseguir el código para obtener el acces_token

Redirige al usuario a la URL de autorización de Strava con tu client_id:
https://www.strava.com/oauth/authorize?client_id=YOUR_CLIENT&response_type=code&redirect_uri=YOUR_REDIRECT_URL&scope=read,activity:read_all&approval_prompt=force
En la parte de YOUR_REDIRECT_URI colocamos http://localhost y así nos devolvera el código en una redirección.
Y en la parte final de la url colocamos approval_prompt=force para garantizar que el usuario vuelva a autorizar la aplicación, incluso si ya lo había hecho antes. Esto es útil para asegurararnos de que obtienemos los permisos adecuados.
Se nos mostrará una página para autorizar nuestra aplicación API

Una vez le damos a autorizar, el usuario será redirigido de vuelta a la redirect_uri con un código como parámetro dentro de la URL. Copia o toma nota de ese código. Un ejemplo de esa redirección que se nos mostrará sera esta: https://localhost/?state=&code=AQUI_VENDRÁ_EL_CÓDIGO&scope=read,activity:read_all
Usa ese código para solicitar un access_token haciendo una petición POST. Para ello vamos a hacerlo con Postman, que es una aplicación para construir, probar y documentar APIs.

Usar Postman para conseguir el acces_token

Crea una nueva solicitud en Postman
∘ Abre Postman y haz clic en "New" → "Request".
∘ Ponle un nombre a la solicitud, como "Strava Activities" y elige una colección o crea una nueva para guardar tu solicitud.
Configurar la solicitud POST
∘ Método: POST
∘ URL: https://www.strava.com/oauth/token?
En el cuerpo de la solicitud (Query Params), debes incluir:
∘ client_id
∘ client_secret
∘ code El código de la url de la reedirección anterior
∘ grant_type Aquí coloca authorization_code
∘ scope Este valor coloca activity:read_all

Recibirás un objeto JSON que incluye el access_token. A partir de ahí podrás usarlo para hacer solicitudes a la API de Strava.

3º Obtener datos de rutas de Strava

Una vez que tienes un access_token, puedes hacer solicitudes a los endpoints de la API de Strava.

Por ejemplo, para obtener las actividades recientes de un usuario en Postman:

Dentro de tu colección crea una nueva request del tipo GET
Introduce este endpoint en la solicitud https://www.strava.com/api/v3/athlete/activities
En la pestaña de Autorization, en el desplegable, elige Bearer Token
En el campo Token coloca el acces_token que has obtenido anteriormente en la solicitud POST

Esto te devolverá un array con todas las actividades del usuario:

Bien, ahora ya tenemos los datos de todas nuestras actividades. En los siguientes posts veremos como podemos pintarlos en una tabla en Notion y ya filtrarlos como queramos, además de automatizar el proceso de actualización del access_token.

Si quieres comentar algo sobre este post o cualquier duda puedes hacerlo en el siguiente hilo de Bluesky: