Sdílet prostřednictvím


Fitbit (Independent Publisher) (Preview)

Způsob přístupu k webovému rozhraní API Fitbit

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Ashwin Ganesh Kumar
URL https://www.blisdigital.com/
Email a.kumar@blisdigital.com
Metadata konektoru
Vydavatel Ashwin Ganesh Kumar
Internetová stránka https://dev.fitbit.com//
Zásady ochrany osobních údajů https://www.fitbit.com/global/nl/legal/privacy-policy
Kategorie Data

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Získat odznáčky

Načte seznam odznáček uživatele.

Získat profil

Načte data profilu uživatele.

Získat tabulku výsledků přátel

Tento koncový bod vrátí tabulku výsledků přítele uživatele.

Získat zařízení

Načte seznam zařízení Fitbit spárovaných s účtem uživatele.

Získání aktivity TCX

Trénovací centrum XML (TCX) je formát výměny dat, který obsahuje GPS, srdeční frekvence a lap data. Tento koncový bod načte podrobnosti o poloze uživatele pomocí GPS a dat srdeční frekvence během protokolovaného cvičení.

Získání alarmů

Načte alarmy povolené pro konkrétní zařízení.

Získání cíle spánku

Zadejte kódované ID uživatele. Pro aktuálního přihlášeného uživatele použijte "-" (pomlčka).

Získání cílů aktivity

Načte aktuální denní nebo týdenní cíle aktivity uživatele.

Získání cílů těla

Načte cíle tělesného tuku a hmotnosti uživatele.

Získání denního souhrnu aktivit

Načte souhrn a seznam aktivit uživatele a položek protokolu aktivit pro daný den.

Získání maximálního souhrnu VO2 podle data

Vrátí data kardio fitness skóre (označovaná také jako VO2 Max) pro jedno datum. Maximální hodnoty VO2 se zobrazí jako rozsah, pokud nejsou k dispozici žádná data spuštění, nebo jedna číselná hodnota, pokud uživatel pro běhy používá GPS. Další informace najdete v tématu Další informace o dalším kontextu.

Získání nedávných typů aktivit

Načte seznam posledních typů aktivit uživatele protokolovaných s podrobnostmi o posledním protokolu aktivit daného typu.

Získání oblíbených aktivit

Načte seznam oblíbených aktivit uživatele.

Získání protokolu hmotnosti

Načte seznam všech položek protokolu hmotnosti uživatele pro dané datum.

Získání protokolu režimu spánku podle data

Vrátí seznam položek protokolu spánku uživatele pro dané datum.

Získání protokolu režimu spánku podle rozsahu dat

Vrátí seznam položek protokolu spánku uživatele pro rozsah kalendářních dat.

Získání protokolu tělesného tuku

Načte seznam všech položek protokolu tělesného tuku uživatele pro dané datum.

Získání seznamu protokolu aktivit

Načte seznam položek protokolu aktivit uživatele před nebo po daném dni.

Získání seznamu protokolů režimu spánku

Vrátí seznam položek protokolu spánku uživatele před nebo po daném datu.

Získání souhrnu HRV podle data

Tento koncový bod vrátí data variability srdeční frekvence (HRV) pro jedno datum.

Získání souhrnu rychlosti dýchání podle data

Tento koncový bod vrátí data průměrné rychlosti dýchání pro jedno datum. Data o rychlosti dýchání se vztahují konkrétně na "hlavní spánek" uživatele, což je nejdelší jednorázová doba, během které spali v daném datu.

Získání statistik životnosti

Načte statistiku aktivity uživatele.

Získání typu aktivity

Načte podrobnosti o jedné aktivitě z databáze aktivit Fitbit v požadovaném formátu. Pokud je k dispozici, zobrazí se podrobnosti na úrovni aktivity.

Získání váhy časové řady podle data

Načte seznam všech položek protokolu hmotnosti uživatele za dané období.

Získání všech typů aktivit

Načte seznam všech platných veřejných aktivit Fitbitu a soukromých aktivit vytvořených uživatelem z databáze aktivit Fitbit ve formátu požadovaném formátu. Pokud je k dispozici, zobrazí se podrobnosti na úrovni aktivity.

Získání základní časové řady podle data

Načte seznam všech uživatelů bmi, tělesného tuku nebo hmotnosti pro dané období.

Získání časové řady aktivit podle data

Načte data aktivit pro daný prostředek v určitém časovém období zadáním data a časového období. Odpověď bude obsahovat pouze denní souhrnné hodnoty.

Získání časové řady body fat podle data

Načte seznam položek protokolu tělesného tuku všech uživatelů za dané období.

Získání častých aktivit

Načte seznam častých aktivit uživatele.

Získat odznáčky

Načte seznam odznáček uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
odznaky
badges array of object

odznaky

badgeGradientEndColor
badges.badgeGradientEndColor string

badgeGradientEndColor

badgeGradientStartColor
badges.badgeGradientStartColor string

badgeGradientStartColor

badgeType
badges.badgeType string

Typ přijatého odznáčku

kategorie
badges.category string

kategorie

Zdravím
badges.cheers array of

Zdravím

datum a čas
badges.dateTime string

Datum, kdy byl odznáček dosažen.

popis
badges.description string

popis

earnedMessage
badges.earnedMessage string

earnedMessage

encodedId
badges.encodedId string

encodedId

image100px
badges.image100px string

image100px

image125px
badges.image125px string

image125px

image300px
badges.image300px string

image300px

image50px
badges.image50px string

image50px

image75px
badges.image75px string

image75px

marketingDescription
badges.marketingDescription string

marketingDescription

mobileDescription
badges.mobileDescription string

mobileDescription

název
badges.name string

název

shareImage640px
badges.shareImage640px string

shareImage640px

shareText
badges.shareText string

shareText

krátký popis
badges.shortDescription string

krátký popis

shortName
badges.shortName string

shortName

timesAchieved
badges.timesAchieved integer

Počet, kolikrát uživatel dosáhl odznáček

value
badges.value integer

Odznak cíl v měření jednotek.

Získat profil

Načte data profilu uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
aboutMe
user.aboutMe string

Informace o mně zadané v nastavení účtu uživatele.

věk
user.age string

Věk založený na jejich zadaných narozeninách v nastavení účtu uživatele.

velvyslanec
user.ambassador string

velvyslanec

autoStrideEnabled
user.autoStrideEnabled string

autoStrideEnabled

avatar
user.avatar string

avatar

avatar150
user.avatar150 string

avatar150

avatar640
user.avatar640 string

avatar640

averageDailySteps
user.averageDailySteps string

Průměrný denní postup vypočítaný pro uživatele

výzvyBeta
user.challengesBeta string

výzvyBeta

clockTimeDisplayFormat
user.clockTimeDisplayFormat string

clockTimeDisplayFormat

země
user.country string

země

podnikový
user.corporate string

podnikový

corporateAdmin
user.corporateAdmin string

corporateAdmin

dateOfBirth
user.dateOfBirth string

dateOfBirth

zobrazované jméno
user.displayName string

zobrazované jméno

displayNameSetting
user.displayNameSetting string

displayNameSetting

jednotka vzdálenosti
user.distanceUnit string

jednotka vzdálenosti

encodedId
user.encodedId string

encodedId

cvičeníGoal
user.features.exerciseGoal string

cvičeníGoal

křestní jméno
user.firstName string

křestní jméno

foodLocale
user.foodsLocale string

foodLocale

fullName
user.fullName string

fullName

gender
user.gender string

gender

glukózaUnit
user.glucoseUnit string

glukózaUnit

výška
user.height string

Hodnota výšky zadaná v nastavení účtu uživatele.

heightUnit
user.heightUnit string

heightUnit

isBugReportEnabled
user.isBugReportEnabled string

isBugReportEnabled

isChild
user.isChild string

isChild

isCoach
user.isCoach string

isCoach

languageLocale
user.languageLocale string

languageLocale

lastName
user.lastName string

lastName

legalTermsAcceptRequired
user.legalTermsAcceptRequired string

legalTermsAcceptRequired

národní prostředí
user.locale string

národní prostředí

memberSince
user.memberSince string

memberSince

mfaEnabled
user.mfaEnabled string

mfaEnabled

offsetFromUTCMillis
user.offsetFromUTCMillis string

offsetFromUTCMillis

SdkDeveloper
user.sdkDeveloper string

SdkDeveloper

sleepTracking
user.sleepTracking string

sleepTracking

startDayOfWeek
user.startDayOfWeek string

startDayOfWeek

stav
user.state string

stav

strideLengthRunning
user.strideLengthRunning string

strideLengthRunning

strideLengthRunningType
user.strideLengthRunningType string

strideLengthRunningType

strideLengthWalking
user.strideLengthWalking string

strideLengthWalking

strideLengthWalkingType
user.strideLengthWalkingType string

strideLengthWalkingType

plavecká jednotka
user.swimUnit string

plavecká jednotka

temperatureUnit
user.temperatureUnit string

temperatureUnit

timezone
user.timezone string

timezone

topBadges
user.topBadges string

Pole se seznamem odznáček Fitbit, které aktuálně uživatel získal.

vodaUnit
user.waterUnit string

vodaUnit

waterUnitName
user.waterUnitName string

waterUnitName

weight
user.weight string

weight

jednotka hmotnosti
user.weightUnit string

jednotka hmotnosti

Získat tabulku výsledků přátel

Tento koncový bod vrátí tabulku výsledků přítele uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
data
data array of object

data

typ
data.type string

typ

identifikační číslo
data.id string

identifikační číslo

step-rank
data.attributes.step-rank integer

Řazení mezi přáteli uživatele.

step-summary
data.attributes.step-summary integer

Týdenní počet kroků.

typ
data.relationships.user.data.type string

typ

identifikační číslo
data.relationships.user.data.id string

identifikační číslo

zahrnutý
included array of object

zahrnutý

typ
included.type string

typ

identifikační číslo
included.id string

identifikační číslo

avatar
included.attributes.avatar string

Odkaz na obrázek avatara uživatele

podřízený
included.attributes.child boolean

podřízený

Přítel
included.attributes.friend boolean

Přítel

název
included.attributes.name string

název

Získat zařízení

Načte seznam zařízení Fitbit spárovaných s účtem uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
array of object
baterie
battery string

Vrátí úroveň baterie zařízení.

batteryLevel
batteryLevel integer

Vrátí procento úrovně baterie zařízení.

deviceVersion
deviceVersion string

Název produktu zařízení.

features
features array of

features

identifikační číslo
id string

ID zařízení.

lastSyncTime
lastSyncTime string

Časové razítko představující poslední synchronizaci zařízení s mobilní aplikací Fitbit

gumák
mac string

Číslo ID macu

typ
type string

TRACKER | ŠKÁLA

Získání aktivity TCX

Trénovací centrum XML (TCX) je formát výměny dat, který obsahuje GPS, srdeční frekvence a lap data. Tento koncový bod načte podrobnosti o poloze uživatele pomocí GPS a dat srdeční frekvence během protokolovaného cvičení.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID použití

ID protokolu
log-id True string

ID protokolu aktivity.

Částečný TCX
includePartialTCX boolean

Zahrnuje body TCX, pokud nejsou k dispozici data GPS.

Získání alarmů

Načte alarmy povolené pro konkrétní zařízení.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

ID sledování
tracker-id True string

ID sledování, pro které jsou data vrácena.

Návraty

Name Cesta Typ Description
trackerAlarms
trackerAlarms array of object

trackerAlarms

alarmId
trackerAlarms.alarmId integer

Číselná hodnota představující ID alarmu

smazaný
trackerAlarms.deleted boolean

Označuje, jestli byl odstraněn alarm.

enabled
trackerAlarms.enabled boolean

Označuje, jestli je zapnutý alarm.

opakovaný
trackerAlarms.recurring boolean

Označuje, jestli je alarm opakovaný.

snoozeCount
trackerAlarms.snoozeCount integer

Udává, kolikrát se alarm odblokuje.

snoozeLength
trackerAlarms.snoozeLength integer

Určuje čas v minutách mezi obdobími snooze.

syncedToDevice
trackerAlarms.syncedToDevice boolean

true | falešný

time
trackerAlarms.time string

Čas a posun UTC pro zadaný alarm.

vibrace
trackerAlarms.vibe string

Vrátí typ nakonfigurovaného kmitání.

weekDays
trackerAlarms.weekDays array of string

weekDays

Získání cíle spánku

Zadejte kódované ID uživatele. Pro aktuálního přihlášeného uživatele použijte "-" (pomlčka).

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
flowId
consistency.flowId integer

0 = Je nastaven cíl spánku, ale není zaznamenán dostatek protokolů režimu spánku. 1 = Uživatel buď zmeškal cíl spánku, nebo není nastavený žádný cíl, ale zaznamená se dostatek protokolů režimu spánku. 2 = Cíl spánku není nastavený a není zaznamenán dostatek protokolů režimu spánku. 3 = Uživatel dosáhl svého cíle spánku

minDuration
goal.minDuration integer

Délka období cíle spánku v minutách.

aktualizovánoOn
goal.updatedOn string

Časové razítko, které bylo cílem vytvořeno nebo aktualizováno.

Získání cílů aktivity

Načte aktuální denní nebo týdenní cíle aktivity uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Období
period True string

denně| týdně

Návraty

Name Cesta Typ Description
activeMinutes
goals.activeMinutes integer

Cíl denních aktivních minut. Hodnota se nevrátí pro týdenní cíle.

activeZoneMinutes
goals.activeZoneMinutes integer

Denní nebo týdenní cíl minut aktivní zóny.

kaloriíOut
goals.caloriesOut integer

Denní kalorií spálil cíl. Hodnota se nevrátí pro týdenní cíle.

distance
goals.distance float

Denní nebo týdenní cíl vzdálenosti.

podlaží
goals.floors integer

Denní nebo týdenní patra vylezla za cíl.

steps
goals.steps integer

Denní nebo týdenní kroky, které byly přijaty jako cíl.

Získání cílů těla

Načte cíle tělesného tuku a hmotnosti uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Typ cíle
goal-type True string

Typ cíle

Návraty

Name Cesta Typ Description
goalType
goal.goalType string
startDate
goal.startDate string

Datum zahájení cíle.

startWeight
goal.startWeight float

Váha uživatele při vytvoření cíle

weight
goal.weight float

Cíl váhy, který chcete dosáhnout.

weightThreshold
goal.weightThreshold float

Doporučené množství hmotnosti, které se má každý týden ztratit, aby bylo dosaženo a udržovat cíl.

Získání denního souhrnu aktivit

Načte souhrn a seznam aktivit uživatele a položek protokolu aktivit pro daný den.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Date

Návraty

Name Cesta Typ Description
activities
activities array of

activities

activeMinutes
goals.activeMinutes integer

activeMinutes

kaloriíOut
goals.caloriesOut integer

kaloriíOut

distance
goals.distance float

distance

podlaží
goals.floors integer

podlaží

steps
goals.steps integer

steps

activeScore
summary.activeScore integer

activeScore

activityCalories
summary.activityCalories integer

activityCalories

calorieEstimationMu
summary.calorieEstimationMu integer

calorieEstimationMu

kaloriíBMR
summary.caloriesBMR integer

kaloriíBMR

kaloriíOut
summary.caloriesOut integer

kaloriíOut

kaloriíOutUnestimated
summary.caloriesOutUnestimated integer

kaloriíOutUnestimated

customHeartRateZones
summary.customHeartRateZones array of object

customHeartRateZones

kaloriíOut
summary.customHeartRateZones.caloriesOut integer

kaloriíOut

max
summary.customHeartRateZones.max integer

max

min
summary.customHeartRateZones.min integer

min

minutes
summary.customHeartRateZones.minutes integer

minutes

název
summary.customHeartRateZones.name string

název

vzdálenosti
summary.distances array of object

vzdálenosti

aktivita
summary.distances.activity string

<název> aktivity | total | tracker | loggedActivities | veryActive | moderatelyActive | lightlyActive | active | activeyActive

distance
summary.distances.distance integer

U zadaného zdroje vzdálenost cestovaná za den zobrazená v jednotkách definovaných hlavičkou Accept-Language.

nadmořská výška
summary.elevation integer

Zvýšení oprávnění pro den zobrazené v jednotkách definovaných hlavičkou Accept-Language.

fairlyActiveMinutes
summary.fairlyActiveMinutes integer

Celkový počet minut, po které byl uživatel poměrně nebo středně aktivní.

podlaží
summary.floors integer

Ekvivalentní podlahy vylezly za den zobrazené v jednotkách definovaných záhlavím Accept-Language.

heartRateZones
summary.heartRateZones array of object

heartRateZones

kaloriíOut
summary.heartRateZones.caloriesOut integer

kaloriíOut

max
summary.heartRateZones.max integer

max

min
summary.heartRateZones.min integer

min

minutes
summary.heartRateZones.minutes integer

minutes

název
summary.heartRateZones.name string

K zobrazení této hodnoty se vyžaduje rozsah srdeční frekvence. Mimo rozsah | Fat Burn | Kardio | Vrchol

lightlyActiveMinutes
summary.lightlyActiveMinutes integer

Celkový počet minut, po které byl uživatel mírně aktivní.

marginCalories
summary.marginalCalories integer

Celkové mezní odhadované kalorií spálené na den.

restingHeartRate
summary.restingHeartRate integer

K zobrazení této hodnoty se vyžaduje rozsah srdeční frekvence.

nýtyMinutes
summary.sedentaryMinutes integer

Celkový počet minut, kdy byl uživatel ochutná.

steps
summary.steps integer

Celkový počet provedených kroků pro tento den

useEstimation
summary.useEstimation boolean

Logická hodnota, která udává, jestli se ve výpočtech používají odhady.

velmiActiveMinutes
summary.veryActiveMinutes integer

Celkový počet minut, po které byl uživatel velmi aktivní.

Získání maximálního souhrnu VO2 podle data

Vrátí data kardio fitness skóre (označovaná také jako VO2 Max) pro jedno datum. Maximální hodnoty VO2 se zobrazí jako rozsah, pokud nejsou k dispozici žádná data spuštění, nebo jedna číselná hodnota, pokud uživatel pro běhy používá GPS. Další informace najdete v tématu Další informace o dalším kontextu.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Datum ve formátu rrrr-mm-dd nebo dnes.

Návraty

Name Cesta Typ Description
kardioScore
cardioScore array of object

kardioScore

datum a čas
cardioScore.dateTime string

Datum zadané ve formátu RRRR-MM-DD.

vo2Max
cardioScore.value.vo2Max string

Zobrazená hodnota VO2 Max v mL/kg/min

Získání nedávných typů aktivit

Načte seznam posledních typů aktivit uživatele protokolovaných s podrobnostmi o posledním protokolu aktivit daného typu.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
array of object
activityId
activityId integer

Číselné ID aktivity nebo cvičení

kalorie
calories integer

Počet kalorií spálených během zaznamenané aktivity.

popis
description string

Informace o aktivitě nebo cvičení, pokud jsou k dispozici.

distance
distance integer

Vzdálenost se pohybuje během zaznamenané aktivity.

duration
duration integer

Doba (milisekundy) k dokončení zaznamenané aktivity.

název
name string

Název aktivity nebo cvičení

Získání oblíbených aktivit

Načte seznam oblíbených aktivit uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
array of object
activityId
activityId integer

Číslo identifikátoru zaznamenané aktivity.

popis
description string

Další informace o zaznamenané aktivitě

Mets
mets integer

Metabolismus (MET) provedené aktivity.

název
name string

Název zaznamenané aktivity.

Získání protokolu hmotnosti

Načte seznam všech položek protokolu hmotnosti uživatele pro dané datum.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Datum ve formátu rrrr-mm-dd

Návraty

Name Cesta Typ Description
weight
weight array of object

weight

Bmi
weight.bmi float

Počítané BMI ve formátu X.XX

date
weight.date string

Datum zápisu ve formátu rrrr-mm-dd.

tuk
weight.fat integer
logId
weight.logId integer

ID protokolu váhy jsou pro uživatele jedinečná, ale ne globálně jedinečná.

odeslat k provedení
weight.source string

odeslat k provedení

time
weight.time string

Čas měření; hodiny a minuty ve formátu HH:mm:ss, pokud nejsou k dispozici, nastavte na poslední sekundu dne.

weight
weight.weight integer

Váha ve formátu X.XX, v systému jednotek, která odpovídá Accept-Language hlavičky poskytnuté nebo pokud není zadána v metrice.

Získání protokolu režimu spánku podle data

Vrátí seznam položek protokolu spánku uživatele pro dané datum.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

yyyy-mm-dd

Návraty

Name Cesta Typ Description
sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string

Datum ukončení protokolu spánku

duration
sleep.duration integer

Délka spánku v milisekundách.

efektivita
sleep.efficiency integer

Počítané skóre efektivity spánku. Toto není skóre režimu spánku dostupné v mobilní aplikaci.

endTime
sleep.endTime string

Čas ukončení protokolu spánku.

infoCode
sleep.infoCode integer

Celočíselná hodnota představující kvalitu dat shromážděných v protokolu spánku. 0 = Dostatečná data pro vygenerování protokolu režimu spánku. 1 = nedostatečná data srdeční frekvence. 2 = období spánku bylo příliš krátké (méně než 3 hodiny). 3 = Problém na straně serveru.

isMainSleep
sleep.isMainSleep boolean

logický

data
sleep.levels.data array of object

data

datum a čas
sleep.levels.data.dateTime string

datum a čas

úroveň
sleep.levels.data.level string

úroveň

sekundy
sleep.levels.data.seconds integer

sekundy

shortData
sleep.levels.shortData array of object

shortData

datum a čas
sleep.levels.shortData.dateTime string

datum a čas

úroveň
sleep.levels.shortData.level string

úroveň

sekundy
sleep.levels.shortData.seconds integer

sekundy

count
sleep.levels.summary.deep.count integer

count

minutes
sleep.levels.summary.deep.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

logId
sleep.logId integer

ID protokolu režimu spánku.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

Celkový počet minut po probuzení uživatele.

minutesAsleep
sleep.minutesAsleep integer

Celkový počet minut, po které uživatel usnul.

minutesAwake
sleep.minutesAwake integer

Celkový součet "probuzení" minut. Nezahrnuje před usnutím nebo po probuzení.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

Celkový počet minut, než uživatel usne. Tato hodnota je obecně 0 pro protokoly režimu spánku vytvořené automatickým režimem spánku.

Typ protokolu
sleep.logType string

auto_detected | manuál

startTime
sleep.startTime string

Čas zahájení protokolu spánku.

timeInBed
sleep.timeInBed integer

Celkový počet minut, po které byl uživatel v posteli.

typ
sleep.type string

Classic | stupně

hluboký
summary.stages.deep integer

hluboký

světlo
summary.stages.light integer

světlo

rem
summary.stages.rem integer

rem

vzbudit
summary.stages.wake integer

vzbudit

totalMinutesAsleep
summary.totalMinutesAsleep integer

Celkový počet minut, po které uživatel spal ve všech záznamech režimu spánku v protokolu spánku

totalSleepRecords
summary.totalSleepRecords integer

Počet záznamů o režimu spánku v protokolu spánku.

totalTimeInBed
summary.totalTimeInBed integer

Celkový počet minut, po které byl uživatel v posteli ve všech záznamech v protokolu spánku.

Získání protokolu režimu spánku podle rozsahu dat

Vrátí seznam položek protokolu spánku uživatele pro rozsah kalendářních dat.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Datum zahájení
startDate True string

Datum vrácení prvního protokolu spánku (yyyy-mm-dd)

Datum ukončení
endDate True string

Datum posledního protokolu spánku, které se má vrátit (yyyy-mm-dd)

Návraty

Name Cesta Typ Description
sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string

Datum ukončení protokolu spánku.

duration
sleep.duration integer

Délka spánku v milisekundách.

efektivita
sleep.efficiency integer

Počítané skóre efektivity spánku. Toto není skóre režimu spánku dostupné v mobilní aplikaci.

endTime
sleep.endTime string

Čas ukončení protokolu spánku.

infoCode
sleep.infoCode integer

Celočíselná hodnota představující kvalitu dat shromážděných v protokolu spánku. 0 = Dostatečná data pro vygenerování protokolu režimu spánku. 1 = nedostatečná data srdeční frekvence. 2 = období spánku bylo příliš krátké (méně než 3 hodiny). 3 = Problém na straně serveru.

isMainSleep
sleep.isMainSleep boolean

logický

data
sleep.levels.data array of object

data

datum a čas
sleep.levels.data.dateTime string

datum a čas

úroveň
sleep.levels.data.level string

úroveň

sekundy
sleep.levels.data.seconds integer

sekundy

count
sleep.levels.summary.asleep.count integer

count

minutes
sleep.levels.summary.asleep.minutes integer

minutes

count
sleep.levels.summary.awake.count integer

count

minutes
sleep.levels.summary.awake.minutes integer

minutes

count
sleep.levels.summary.restless.count integer

count

minutes
sleep.levels.summary.restless.minutes integer

minutes

count
sleep.levels.summary.deep.count integer

count

minutes
sleep.levels.summary.deep.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

shortData
sleep.levels.shortData array of object

shortData

datum a čas
sleep.levels.shortData.dateTime string

datum a čas

úroveň
sleep.levels.shortData.level string

úroveň

sekundy
sleep.levels.shortData.seconds integer

sekundy

logId
sleep.logId integer

ID protokolu režimu spánku.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

Celkový počet minut po probuzení uživatele.

minutesAsleep
sleep.minutesAsleep integer

Celkový počet minut, po které uživatel usnul.

minutesAwake
sleep.minutesAwake integer

Celkový součet "probuzení" minut. Nezahrnuje před usnutím nebo po probuzení.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

Celkový počet minut, než uživatel usne. Tato hodnota je obecně 0 pro protokoly režimu spánku vytvořené automatickým režimem spánku.

Typ protokolu
sleep.logType string

auto_detected | manuál

startTime
sleep.startTime string

Čas zahájení protokolu spánku

timeInBed
sleep.timeInBed integer

Celkový počet minut, po které byl uživatel v posteli

typ
sleep.type string

Classic | stupně

Získání protokolu tělesného tuku

Načte seznam všech položek protokolu tělesného tuku uživatele pro dané datum.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Datum ve formátu rrrr-mm-dd.

Návraty

Name Cesta Typ Description
tuk
fat array of object

tuk

date
fat.date string

Datum, kdy byl zaznamenán protokol tělesného tuku.

tuk
fat.fat integer

Procento tělesného tuku.

logId
fat.logId integer

ID protokolu tělesného tuku.

odeslat k provedení
fat.source string

Umístění, odkud pocházejí údaje o tělesném tuku.

time
fat.time string

Časové razítko, kdy byl zaznamenán protokol tělesného tuku.

Získání seznamu protokolu aktivit

Načte seznam položek protokolu aktivit uživatele před nebo po daném dni.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Po datu
afterDate string

Po datu (yyyy-mm-dd)

Před datem
beforeDate string

Datum před (yyyy-mm-dd)

Seřadit
sort string

Pořadířazeních

Omezení
limit integer

Počet vrácených položek.

Návraty

Name Cesta Typ Description
activities
activities array of object

activities

activeDuration
activities.activeDuration integer

Doba (milisekundy) v rámci každé úrovně aktivity.

activityLevel
activities.activityLevel array of object

activityLevel

minutes
activities.activityLevel.minutes integer

minutes

název
activities.activityLevel.name string

název

activityName
activities.activityName string

Název zaznamenaného cvičení

activityTypeId
activities.activityTypeId integer

Číslo identifikátoru activityName.

kalorie
activities.calories integer

Počet kalorií spálených během cvičení.

kaloriíLink
activities.caloriesLink string

Koncový bod webového rozhraní API pro volání za účelem spálení konkrétních kalorií pro pojmenované cvičení.

duration
activities.duration integer

Doba trvání (milisekundy) po úpravě cvičení Pokud cvičení nebylo upraveno, doba trvání = originalDuration. Tato hodnota bude obsahovat pozastavení během cvičení.

elevationGain
activities.elevationGain float

Zvýšení oprávnění získané během cvičení

naposledy upraveno
activities.lastModified string

Časové razítko, které cvičení naposledy změnilo.

logId
activities.logId integer

Identifikátor protokolu aktivit pro cvičení.

Typ protokolu
activities.logType string

auto_detected | ruční | mobile_run | tracker | název aplikace třetí strany

kalorie
activities.manualValuesSpecified.calories boolean

Logická hodnota, která udává, jestli se při záznamu cvičení poskytly kalorií.

distance
activities.manualValuesSpecified.distance boolean

Logická hodnota, která udává, jestli byla při nahrávání cvičení zadána vzdálenost.

steps
activities.manualValuesSpecified.steps boolean

Logická hodnota, která udává, jestli byly při nahrávání cvičení poskytnuty kroky.

originalDuration
activities.originalDuration integer

Počáteční doba (milisekundy), kterou cvičení zaznamenalo. Tato hodnota bude obsahovat pozastavení během cvičení.

originalStartTime
activities.originalStartTime string

Počáteční počáteční datum a čas, kdy bylo cvičení zaznamenáno.

startTime
activities.startTime string

Počáteční datum a čas po úpravě cvičení Pokud cvičení nebylo upraveno, startTime = originalStartTime.

steps
activities.steps integer

Počet kroků provedených během cvičení

tcxLink
activities.tcxLink string

Adresa URL pro stažení souboru TCX.

afterDate
pagination.afterDate string

afterDate

limit
pagination.limit integer

limit

next
pagination.next string

next

posun
pagination.offset integer

posun

předchozí
pagination.previous string

předchozí

řadit
pagination.sort string

řadit

Získání seznamu protokolů režimu spánku

Vrátí seznam položek protokolu spánku uživatele před nebo po daném datu.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Po datu
afterDate string

Po datu, kdy se vrátí protokol spánku uživatele (yyyy-mm-dd)

Před datem
beforeDate string

Před datem, kdy se vrátí protokol spánku uživatele (yyyy-mm-dd)

Seřadit
sort string

vzestupně nebo sestupně

Omezení
limit integer

Počet protokolů režimu spánku, které se mají vrátit. (max. 100)

Návraty

Name Cesta Typ Description
afterDate
pagination.afterDate string

afterDate

limit
pagination.limit integer

limit

next
pagination.next string

next

posun
pagination.offset integer

posun

předchozí
pagination.previous string

předchozí

řadit
pagination.sort string

řadit

sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string
duration
sleep.duration integer

duration

efektivita
sleep.efficiency integer

efektivita

endTime
sleep.endTime string

endTime

infoCode
sleep.infoCode integer

infoCode

isMainSleep
sleep.isMainSleep boolean

isMainSleep

data
sleep.levels.data array of object

data

datum a čas
sleep.levels.data.dateTime string

datum a čas

úroveň
sleep.levels.data.level string

úroveň

sekundy
sleep.levels.data.seconds integer

sekundy

shortData
sleep.levels.shortData array of object

shortData

datum a čas
sleep.levels.shortData.dateTime string

datum a čas

úroveň
sleep.levels.shortData.level string

úroveň

sekundy
sleep.levels.shortData.seconds integer

sekundy

count
sleep.levels.summary.deep.count integer

count

minutes
sleep.levels.summary.deep.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

třicetDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

třicetDayAvgMinutes

logId
sleep.logId integer

logId

Typ protokolu
sleep.logType string

Typ protokolu

minutesAfterWakeup
sleep.minutesAfterWakeup integer

minutesAfterWakeup

minutesAsleep
sleep.minutesAsleep integer

minutesAsleep

minutesAwake
sleep.minutesAwake integer

minutesAwake

minutesToFallAsleep
sleep.minutesToFallAsleep integer

minutesToFallAsleep

startTime
sleep.startTime string

startTime

timeInBed
sleep.timeInBed integer

timeInBed

typ
sleep.type string

typ

Získání souhrnu HRV podle data

Tento koncový bod vrátí data variability srdeční frekvence (HRV) pro jedno datum.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Datum ve formátu rrrr-MM-dd nebo dnes.

Návraty

Name Cesta Typ Description
hrv
hrv array of object

hrv

dailyRmssd
hrv.value.dailyRmssd float

Kořenový střední čtverec po sobě jdoucích rozdílů (RMSSD) mezi srdečními beaty. Měří krátkodobou variabilitu v denní srdeční frekvenci uživatele v milisekundách (ms).

deepRmssd
hrv.value.deepRmssd float

Kořenový střední čtverec po sobě jdoucích rozdílů (RMSSD) mezi srdečními beaty. Měří krátkodobou variabilitu srdeční frekvence uživatele v hlubokém spánku v milisekundách (ms).

datum a čas
hrv.dateTime string

Datum protokolu spánku zadané ve formátu RRRR-MM-DD.

Získání souhrnu rychlosti dýchání podle data

Tento koncový bod vrátí data průměrné rychlosti dýchání pro jedno datum. Data o rychlosti dýchání se vztahují konkrétně na "hlavní spánek" uživatele, což je nejdelší jednorázová doba, během které spali v daném datu.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Datum ve formátu rrrr-mm-dd nebo dnes.

Návraty

Name Cesta Typ Description
Br
br array of object

Br

dechová rychlost
br.value.breathingRate float

Průměrný početdech

datum a čas
br.dateTime string

Datum protokolu spánku zadané ve formátu RRRR-MM-DD.

Získání statistik životnosti

Načte statistiku aktivity uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
date
best.total.distance.date string

date

value
best.total.distance.value float

value

date
best.total.floors.date string

date

value
best.total.floors.value float

value

date
best.total.steps.date string

date

value
best.total.steps.value integer

value

date
best.tracker.distance.date string

date

value
best.tracker.distance.value float

value

date
best.tracker.floors.date string

date

value
best.tracker.floors.value float

value

date
best.tracker.steps.date string

date

value
best.tracker.steps.value integer

value

activeScore
lifetime.total.activeScore integer

activeScore

kaloriíOut
lifetime.total.caloriesOut integer

kaloriíOut

distance
lifetime.total.distance float

distance

podlaží
lifetime.total.floors integer

podlaží

steps
lifetime.total.steps integer

steps

activeScore
lifetime.tracker.activeScore integer

activeScore

kaloriíOut
lifetime.tracker.caloriesOut integer

kaloriíOut

distance
lifetime.tracker.distance float

distance

podlaží
lifetime.tracker.floors integer

podlaží

steps
lifetime.tracker.steps integer

steps

Získání typu aktivity

Načte podrobnosti o jedné aktivitě z databáze aktivit Fitbit v požadovaném formátu. Pokud je k dispozici, zobrazí se podrobnosti na úrovni aktivity.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

ID aktivity
activity-id True string

ID aktivity

Návraty

Name Cesta Typ Description
úroveň přístupu
activity.accessLevel string

PUBLIC | SOUKROMÝ

activityLevels
activity.activityLevels array of object

activityLevels

identifikační číslo
activity.activityLevels.id integer

Číselná hodnota představující odpovídající úroveň aktivity

maxSpeedMPH
activity.activityLevels.maxSpeedMPH float

Maximální rychlost v MPH. Hodnota: -1 znamená, že se nedá použít.

Mets
activity.activityLevels.mets integer

Skóre METs pro ID aktivity.

minSpeedMPH
activity.activityLevels.minSpeedMPH integer

Minimální rychlost v MPH. Hodnota: -1 znamená, že se nedá použít.

název
activity.activityLevels.name string

Název úrovně aktivity.

hasSpeed
activity.hasSpeed boolean

true | falešný

identifikační číslo
activity.id integer

Číselná hodnota představující odpovídající aktivitu

název
activity.name string

Název aktivity nebo cvičení

Získání váhy časové řady podle data

Načte seznam všech položek protokolu hmotnosti uživatele za dané období.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Koncové datum období zadaného ve formátu rrrr-mm-dd nebo dnes.

Období
period True string

Oblast, pro kterou budou vrácena data.

Návraty

Name Cesta Typ Description
weight
weight array of object

weight

Bmi
weight.bmi float

Počítané BMI ve formátu X.XX.

date
weight.date string

Datum zápisu ve formátu rrrr-mm-dd.

tuk
weight.fat integer

Procento tělesného tuku.

logId
weight.logId integer

ID protokolu hmotnosti. Je jedinečný pro uživatele, ale není globálně jedinečný.

odeslat k provedení
weight.source string

Zdroj protokolu hmotnosti.

time
weight.time string

Čas měření; hodiny a minuty ve formátu HH:mm:ss, pokud nejsou k dispozici, nastavte na poslední sekundu dne.

weight
weight.weight integer

Váha ve formátu X.XX, v systému jednotek, která odpovídá Accept-Language hlavičky poskytnuté nebo pokud není zadána v metrice.

Získání všech typů aktivit

Načte seznam všech platných veřejných aktivit Fitbitu a soukromých aktivit vytvořených uživatelem z databáze aktivit Fitbit ve formátu požadovaném formátu. Pokud je k dispozici, zobrazí se podrobnosti na úrovni aktivity.

Návraty

Name Cesta Typ Description
categories
categories array of object

categories

activities
categories.activities array of object

activities

úroveň přístupu
categories.activities.accessLevel string

úroveň přístupu

activityLevels
categories.activities.activityLevels array of object

activityLevels

identifikační číslo
categories.activities.activityLevels.id integer

identifikační číslo

maxSpeedMPH
categories.activities.activityLevels.maxSpeedMPH integer

maxSpeedMPH

Mets
categories.activities.activityLevels.mets integer

Mets

minSpeedMPH
categories.activities.activityLevels.minSpeedMPH integer

minSpeedMPH

název
categories.activities.activityLevels.name string

název

hasSpeed
categories.activities.hasSpeed boolean

hasSpeed

identifikační číslo
categories.activities.id integer

identifikační číslo

název
categories.activities.name string

název

Mets
categories.activities.mets float

Mets

Získání základní časové řady podle data

Načte seznam všech uživatelů bmi, tělesného tuku nebo hmotnosti pro dané období.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Resource
resource True string

Prostředek těla, který se má vrátit.

Date
date True string

Koncové datum období zadaného ve formátu rrrr-mm-dd nebo dnes.

Období
period True string

Oblast, pro kterou budou vrácena data.

Návraty

Name Cesta Typ Description
hmotnost těla
body-weight array of object

hmotnost těla

datum a čas
body-weight.dateTime string

datum a čas

value
body-weight.value string

value

Získání časové řady aktivit podle data

Načte data aktivit pro daný prostředek v určitém časovém období zadáním data a časového období. Odpověď bude obsahovat pouze denní souhrnné hodnoty.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Resource
resource True string

Prostředek dat, která se mají vrátit.

Date
date True string

Koncové datum období zadaného ve formátu rrrr-mm-dd

Období
period True string

Oblast, pro kterou budou vrácena data.

Návraty

Name Cesta Typ Description
activities-steps
activities-steps array of object

activities-steps

datum a čas
activities-steps.dateTime string

datum a čas

value
activities-steps.value string

value

Získání časové řady body fat podle data

Načte seznam položek protokolu tělesného tuku všech uživatelů za dané období.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Date
date True string

Koncové datum období zadaného ve formátu rrrr-mm-dd nebo dnes.

Období
period True string

Oblast, pro kterou budou vrácena data.

Návraty

Name Cesta Typ Description
tuk
fat array of object

tuk

date
fat.date string

Datum, kdy byl zaznamenán protokol tělesného tuku.

tuk
fat.fat float

Procento tělesného tuku.

logId
fat.logId integer

ID protokolu tělesného tuku.

odeslat k provedení
fat.source string

Umístění, odkud pocházejí údaje o tělesném tuku. Další informace najdete v části "zdrojové" hodnoty.

time
fat.time string

Časové razítko, kdy byl zaznamenán protokol tělesného tuku.

Získání častých aktivit

Načte seznam častých aktivit uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
ID uživatele
user-id True string

Kódované ID uživatele

Návraty

Name Cesta Typ Description
array of object
activityId
activityId integer

Číslo identifikátoru zaznamenané aktivity.

kalorie
calories integer

Počet kalorií spálených v souvislosti s aktivitou.

popis
description string

Další informace o zaznamenané aktivitě

distance
distance integer

Vzdálenost odcestovaná přidružená k zaznamenané aktivitě.

duration
duration integer

Doba trvání (milisekundy) po úpravě cvičení Tato hodnota bude obsahovat pozastavení během cvičení.

název
name string

Název zaznamenané aktivity.