https://github.com/fabulator/strava-api-handler

Unofficial handler for Strava API
https://github.com/fabulator/strava-api-handler

Last synced: about 1 year ago
JSON representation

Unofficial handler for Strava API

• Host: GitHub
• URL: https://github.com/fabulator/strava-api-handler
• Owner: fabulator
• License: apache-2.0
• Created: 2018-12-23T16:39:49.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-04-26T17:53:39.000Z (about 1 year ago)
• Last Synced: 2025-04-26T18:32:59.529Z (about 1 year ago)
• Language: TypeScript
• Size: 2.99 MB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Strava API handler

[![npm version](https://badge.fury.io/js/strava-api-handler.svg)](https://badge.fury.io/js/strava-api-handler)

[![renovate-app](https://img.shields.io/badge/renovate-app-blue.svg)](https://renovateapp.com/) 

[![Known Vulnerabilities](https://snyk.io/test/github/fabulator/strava-api-handler/badge.svg)](https://snyk.io/test/github/fabulator/strava-api-handler)

[![codecov](https://codecov.io/gh/fabulator/strava-api-handler/branch/master/graph/badge.svg)](https://codecov.io/gh/fabulator/strava-api-handler) 

[![travis](https://travis-ci.org/fabulator/strava-api-handler.svg?branch=master)](https://travis-ci.org/fabulator/strava-api-handler)

This an unofficial handler for Strava API. Methods for getting, creating and filtering activities are incorporated in API class, other endpoints can be called manually. 

## How it works

It uses a library for handling REST API request - [rest-api-handler](https://github.com/fabulator/rest-api-handler). It is based on browser fetch feature so it needs polyfill.

## How to use

Install npm library:

```

npm install strava-api-handler --save

```

Include fetch polyfill. I recommend cross-fetch:

```javascript

import 'cross-fetch/polyfill';

```

### Authentize

You need to use oAuth. First get login url and then autentize through the code.

```javascript

const { Api, ApiScope } = require('./../dist');

(async () => {

    const api = new Api('CLIENT_ID', 'CLIENT_SECRET');

    // generate login link

    console.log(api.getLoginUrl('http://developers.strava.com', [ApiScope.READ_ALL]));

    // use it and get code

    const token = await api.requestToken({ code: 'AUTH_CODE', grant_type: 'authorization_code' });

    // this is token

    console.log(token);

    // later

    // save it and use later

    api.setAccessToken(token.access_token);

})();

```

### Getting workout/s

To get single activity use getActivity method:

```javascript

const activity = await api.getActivity(775131509);

```

Search for activities:

```javascript

const { DateTime } = require('luxon');

const activities = await api.getActivities({

    after: DateTime.fromObject({

        year: 2018,

        month: 3,

        day: 1,

    }),

    per_page: 2,

});

console.log(activities);

```