fitbit-api-handler
v8.0.0
Published
Unofficial handler for Fitbit API
Downloads
245
Readme
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());