由於之前使用FITBIT api不同
type 要資料時,回傳json檔案格式不盡相同,也並非所有api所提供的URL都能取得資料,因此決定專門整理一篇,將app
type設為client與personal
進行回傳資料格式實測並記錄結果
當app type為client時:
一般的Time
Series:
Resource URL:
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[date]/[period].json
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[date]/[period].json
- 回傳資料:取得僅daily總結資料,包含restingHeartRate(型態同API)
- period:1d、7d、30d、1w、1m,回傳資料是period前所設定的 [ date ] 往回推 [ period ] time,30d與1m差別於,取 [ date ] 往前推算的整整30天,或是 [ date ] 往前推的一個月
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[base-date]/[end-date].json
- 日期可以跨月份任意指定
Intraday Time Series
Resource URL:
當 URL 為
當 URL 為
1.
GET
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/[end-date]/[detail-level].json
2.
GET
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/[end-date]/[detail-level]/time/[start-time]/[end-time].json
3.
GET
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/1d/[detail-level].json
4.
GET
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/1d/[detail-level]/time/[start-time]/[end-time].json
以上URL僅回傳錯誤訊息403
當app
type為personal時:
一般的Time
Series:
Resource URL:
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[date]/[period].json
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[date]/[period].json
- 回傳資料:
- period = 1d,以一分鐘為單位,回傳當日「細度」心率。
- 其餘資料回傳格式同 app type為 client 回傳資料
當 URL 為 https://api.fitbit.com/1/user/[user-id]/activities/heart/date/[base-date]/[end-date].json
- 日期可以跨月份任意指定,回傳資料格式同 app type為 client 回傳資料
Intraday Time Series:
Resource URL:
- 當 URL 為 https://api.fitbit.com/1/user/-/activities/heart/date/[date]/[end-date]/[detail-level].json
實測結果:回傳一般心率值,不包含細度資料
- 當 URL 為
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/[end-date]/[detail-
level]/time/[start-time]/[end-time].json
實測結果:error 400
實測結果:error 400
- 當 URL 為
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/1d/[detail-level].json
實測結果:回傳一般心率資料以及當日00:00至23:59細度刻度資料,刻度以
[ detail-level ] 為單位
- 當 URL 為
https://api.fitbit.com/1/user/-/activities/heart/date/[date]/1d/[detail-level]/time/[start-
time]/[end-time].json
實測結果:回傳一般心率資料以及當日指定時間內細度刻度資料,刻度以
[ detail-level ] 為單位


留言
張貼留言