1. Using the Get Activity Intraday Time Series endpoints, you can pull data from a specific date and time range. For example, if you query https://api.fitbit.com/1/user/-/activities/steps/date/2019-05-29/1d/1min/time/12:00/12:05.json, you would see a response like:
{
"activities-steps": [
{
"dateTime": "2019-05-29",
"value": "572"
}
],
"activities-steps-intraday": {
"dataset": [
{
"time": "12:00:00",
"value": 103
},
{
"time": "12:01:00",
"value": 110
},
{
"time": "12:02:00",
"value": 110
},
{
"time": "12:03:00",
"value": 114
},
{
"time": "12:04:00",
"value": 109
},
{
"time": "12:05:00",
"value": 26
}
],
"datasetInterval": 1,
"datasetType": "minute"
}
}
2. The Device SDK can provide you with real-time/live data. However, you will need to visit the SDK forums for support on this subject.
Otherwise, it seems like the GET endpoint example mentioned in question 1 may also fit your needs. Rather than displaying in 1min intervals, you can set it to 15 min intervals, and you should see a response like this:
{
"activities-steps": [
{
"dateTime": "2019-05-29",
"value": "1317"
}
],
"activities-steps-intraday": {
"dataset": [
{
"time": "12:00:00",
"value": 572
},
{
"time": "12:15:00",
"value": 0
},
{
"time": "12:30:00",
"value": 457
},
{
"time": "12:45:00",
"value": 288
},
{
"time": "13:00:00",
"value": 0
}
],
"datasetInterval": 15,
"datasetType": "minute"
}
}
If you are trying to collect live data in 15 min intervals, the Web API will not fit your use case as you can only pull data that has first synced to a user's account beforehand.
Note: You will need to fill out the Intraday Access Request application before you can enable these endpoints on your application.
3. I don't believe there is any API for pulling minAverageHearRate and maxAverageHeartRate. However, the Get Activity Logs List endpoint does return the averageHeartRate attribute. If this is not the value you are searching for, can you clarify what heart rate data you are looking for in particular?
Steps can be accessed through any activity endpoint, such as the Get Daily Activity Summary endpoint and the Get Activity Time Series endpoints.
Sleep Duration or the Duration attribute can be found within the Get Sleep Logs endpoint.
There isn't a StartTimeInSeconds attribute that I know of, however, you can find the startTime attribute in the Get Sleep Logs endpoint and in the Get Daily Activity Summary endpoint. Can you clarify which data types you are interested in finding this attribute in?
4. Authorization code grant flow tokens have a default expiration of 8 hours. Your application stores the access token and refresh token. It will use the access token to make requests to the Fitbit API. It will use the refresh token to obtain a new access token when the access token expires without having to re-prompt the user.
If you would like your users to have the option of their tokens expiring in 1 day, 1 week, 30 days, or 1 year, I suggest setting your application to using the Implicit Grant Flow. Under this authorization flow, your application receives the access token and refresh token. It will use the access token to make requests to the Fitbit API. It will use the refresh token to obtain a new access token when the access token expires without having to re-prompt the user.
5. I suggest beginning at our Web API Quick Start Guide. This will take you through the basics of how the Web API works, registering your application, and to making HTTP requests to access data.
If you are looking for frequent API updates to when users update their account with new activity data, I suggest looking up our Subscriptions API. This allows third=party applications to be notified when Fitbit user data changes. To put it simply, the API will notify you when the user syncs new data to their account. This will allow you to fetch new data whenever it has been synced to the user's account.
I hope this helps. Let me know if you have any additional questions!
Fitbit Developers oversee the SDK and API forums. We're here to answer questions about Fitbit developer tools, assist with projects, and make sure your voice is heard by the development team.
Best Answer
