Enquiries on Webhook and fitbit activities APIs

[g.siang]

Hi,

Refer to my attachment below, 

Currently, the number of end users whom are using Fitbit device is 686 users. But our backend system received Fitbit calls with more than 800 requests per hour via “POST /v1/fitbit/webhook” endpoint even when it is 2 am or 3 am. 

Is this common?

We expect Fitbit will trigger the call to webhook endpoint at the time end users synced activities into their devices only, but from the backend log that shown, it made us confuse. Does anyone know why there are so many triggers from Fitbit to our backend every hour. 

This made our backend system heavy sometime.

Can someone help and advise on the enquiries below:

1. Can you provide us the frequency, details or behaviours when/how Fitbit will trigger webhook endpoint at Fitbit side?

2. Our backend are also calling those endpoints below to collect user activities data by ourselves. Can fitbit team or anyone with the knowledge share with us if there is any limitation or quota or restriction to the APIs?

              GET https://api.fitbit.com/1/user/{UserID}/activities/steps/date/{DateTime}/{DateTime}.json

              GET https://api.fitbit.com/1.2/user/{UserID}/sleep/date/{DateTime}/{DateTime}.json

Your help and advise is greatly appreciated.
TQ

[Gordon-C]

Hi @g.siang 

It is common to receive activity notifications while a person sleeps.   The activity collection will send notifications for calories burned and heart rate.  If the user leaves the mobile application running while they are sleeping, then the device will continue to sync and provide you with the calories burned while sleeping and their heart rate.

Gordon

[g.siang]

Hi Gordon,

I only need the sleep and steps stats.

Is there any way to turn off calories burned and heart rate?

If there is no feature to turn off from the console, how can we filter out the request from via webhook api?

Regards
Jaren

[Gordon-C]

Through the subscription API, we do not have functionality to disable notifications for calories burned.  If the user did not enable the scope for heart rate, then you would not receive notifications for that data set.   

[g.siang]

Hi Gordon,

On the app level, user is only prompted for 

- Activity and exercise

- Sleep

I don't see any heartrate and calories but we are still getting triggered at webhook endpoint at midnight?

We want to get trigger webhook for number of steps and number of sleeps only.

Anyway to disable this?

Regards
Jaren

[Gordon-C]

If the user is not prompted for "heart rate", then you would not receive notifications for the heart rate data set.   However, calories is part of the activities data set.   We do not have a separate scope or subscription collection for calories.   So, you will receive "activity" notifications if the user enabled the "activity and exercise" scope.

Gordon