This library is a fully typed JavaScript wrapper of the Strava JSON API.
To install the package, run:
npm install strava
or
yarn add strava
The library can be initialized with a refresh token and optionally an access token. If these are not available, see below (Token exchange).
import { Strava } from 'strava'
const strava = new Strava({
client_id: '123',
client_secret: 'abc',
refresh_token: 'def',
})
try {
const activities = await strava.activities.getLoggedInAthleteActivities()
console.log(activities)
} catch (error) {
console.log(error)
}This library will automatically refresh the access token when needed.
In order to store the token, you can use the on_token_refresh callback.
This received an AccessToken object (consisting of access_token, expires_at, and refresh_token).
Note that the refresh token as returned by this call can sometimes change,
at which point the old token becomes invalid.
An AccessToken object can also be passed as a second argument to the Strava constructor.
This can save an initial token refresh.
As AccessToken contains a refresh token,
the first argument does not need to contain a refresh token.
import { Strava } from 'strava'
const strava = new Strava(
{
client_id: '123',
client_secret: 'abc',
on_token_refresh: response => {
cache.accessToken = response
},
},
cache.accessToken,
)When a user logs in for the first time, you will need to perform authorization with OAuth. This involves sending the user to https://www.strava.com/oauth/authorize, and receiving the auth code as a query parameter.
This can be used as follows:
import { Strava } from 'strava'
try {
const strava = await Strava.createFromTokenExchange(
{
client_id: '123',
client_secret: 'abc',
},
token,
)
const activities = await strava.activities.getLoggedInAthleteActivities()
console.log(activities)
} catch (error) {
console.log(error)
}When a user logs in for the first time, the Strava API returns information about the newly logged-in user.
This can be read using the on_token_refresh callback.
Note that this will only ever be provided on the initial token exchange,
before the promise returned from Strava.createFromTokenExchange returns.
When the on_token_refresh callback is called again after the token expires,
response.athlete will always be undefined.
import { Strava } from 'strava'
try {
const strava = await Strava.createFromTokenExchange(
{
client_id: '123',
client_secret: 'abc',
on_token_refresh: response => {
if (response.athlete) {
console.log(response.athlete)
}
db.set('refresh_token', response.refresh_token)
},
},
token,
)
const activities = await strava.activities.getLoggedInAthleteActivities()
console.log(activities)
} catch (error) {
console.log(error)
}Issues and pull requests are welcome.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent