fitbit-api-handler

Fitbit API handler

This is an unofficial web API SDK for Fitbit. Current focus is to work with activities but it is possible to request all other endpoints.

The library is compiled for node 9.6.

How it works

I use a library for handling REST API request - rest-api-handler. It is based on browser fetch feature so it needs polyfill.

How to use

Install npm library:

npm install fitbit-api-handler --save

Include fetch polyfill. I recommend cross-fetch. And you have to include form-data polyfill.

require('cross-fetch/polyfill');
global.FormData = require('form-data');

Authentize

Check authentization methods on Fitbit. First generate url for Login to Fitbit:

const { Api, ApiScope } = require('fitbit-api-handler');
const api = new Api(YOUR_CLIENT_ID, YOUR_CLIENT_SECRET);
console.log(api.getLoginUrl(YOUR_RETURN_URL, [ApiScope.ACTIVITY, ApiScope.PROFILE]))

After login you will be redirected to YOUR_RETURN_URL with code parameter. Use this code to create authentization token:

const token = await api.requestAccessToken(YOUR_CODE, YOUR_RETURN_URL);
api.setAccessToken(token.access_token);

// extend your token
const extendedToken = await api.extendAccessToken(token.refresh_token);

Now you can send requests

Getting activities

Search for activities:

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

const { activities } = await api.getActivities({
    afterDate: DateTime.fromObject({
        year: 2018,
        month: 3,
        day: 1,
    }),
});
console.log(activities);

Create a new activity

To create activity, use ActivityFactory

const { DateTime, Duration } = require('luxon');
const math = require('mathjs');
const { Activity, ACTIVITY_TYPES } = require('fitbit-api-handler');

const start = DateTime.fromObject({
    year: 2018,
    month: 3,
    day: 27,
    hour: 5,
    minute: 2,
});

const activity = Activity.get(
    ACTIVITY_TYPES.RUNNING,
    start,
    Duration.fromObject({ minutes: 3 }),
    math.unit(3, 'km'),
);

const createdActivity = await api.createActivity(activity);

Get information about rate limiting

try {
    await api.createActivity(activity);
} catch (exception) {
    if (exception instanceof FitbitApiLimitException) {
        const retryIn: Duration = exception.retryIn();
        console.log(`Wait for ${retryIn.as('seconds')}`);
    }
}

console.log(api.getFillRateLimits());

Changelog

v7.2.1 (2022-02-06)

Fixed

• 95fabbd Update lock to make security bots happy. (#225)

Co-authored-by: Renovate Bot [e-mail]