Поделиться через

Fitbit (независимый издатель) (предварительная версия)

Способ доступа к веб-API Fitbit

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Ашвин Ганеш Кумар
URL https://www.blisdigital.com/
Адрес электронной почты a.kumar@blisdigital.com
Метаданные соединителя
Publisher Ашвин Ганеш Кумар
Website https://dev.fitbit.com//
Политика конфиденциальности https://www.fitbit.com/global/nl/legal/privacy-policy
Категории Данные

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Получение временных рядов действий по дате

Извлекает данные действия для заданного ресурса за период времени, указав дату и период времени. Ответ будет содержать только ежедневные суммарные значения.
Получение временных рядов жира тела по дате

Извлекает список всех записей журнала жира пользователя за заданный период.
Получение временных рядов по дате

Извлекает список всех записей журнала веса пользователя в течение заданного периода.
Получение временных рядов тела по дате

Извлекает список всех пользователей bmi, жира тела или веса в течение заданного периода.
Получение всех типов действий

Извлекает список всех допустимых общедоступных действий Fitbit и частных действий, созданных пользователем, из базы данных действий Fitbit в запрошенном формате. Если это доступно, будут отображаться сведения о уровне действия.
Получение действия TCX

XML-код Центра обучения (TCX) — это формат обмена данными, содержащий данные GPS, частоты пульса и lap. Эта конечная точка извлекает сведения о расположении пользователя с помощью данных GPS и частоты пульса во время зарегистрированного упражнения.
Получение журнала веса

Извлекает список всех записей журнала веса пользователя для заданной даты.
Получение журнала жира тела

Извлекает список всех записей журнала жира пользователя для заданной даты.
Получение журнала спящего режима по дате

Возвращает список записей журнала спящего режима пользователя для заданной даты.
Получение журнала спящего режима по диапазону дат

Возвращает список записей журнала спящего режима пользователя для диапазона дат.
Получение значков

Извлекает список индикаторов событий пользователя.
Получение избранных действий

Извлекает список любимых действий пользователя.
Получение максимальной сводки по дате VO2

Возвращает данные о сердечно-фитнес-оценке (также известной как VO2 Max) для одной даты. Значения VO2 Max будут отображаться в виде диапазона, если данные о выполнении недоступны или одно числовое значение, если пользователь использует GPS для выполнения. Дополнительные сведения см. в разделе "Дополнительные сведения" для дальнейшего контекста.
Получение оповещений

Извлекает оповещения, включенные для определенного устройства.
Получение последних типов действий

Извлекает список последних типов действий пользователя, зарегистрированных с некоторыми сведениями о последнем журнале действий этого типа.
Получение сводки по дате HRV

Эта конечная точка возвращает данные о частоте пульса (HRV) для одной даты
Получение сводки по ежедневным действиям

Извлекает сводку и список действий пользователя и записей журнала действий в течение определенного дня.
Получение сводки по частоте дыхания по дате

Эта конечная точка возвращает данные средней скорости дыхания для одной даты. Данные частоты дыхания применяются специально к "главному спячному" пользователю, который является самым длинным периодом времени, в течение которого они заснули на заданной дате.
Получение списка журналов действий

Извлекает список записей журнала действий пользователя до или после заданного дня.
Получение списка журналов спящего режима

Возвращает список записей журнала спящего режима пользователя до или после заданной даты
Получение списка лидеров друзей

Эта конечная точка возвращает другую доску лидеров пользователя
Получение статистики времени существования

Извлекает статистику действий пользователя.
Получение целей действий

Извлекает текущие или еженедельные цели действий пользователя.
Получение целей тела

Извлекает жир тела пользователя и цели веса.
Получение цели сна

Укажите кодированный идентификатор пользователя. Используйте "-" (dash) для текущего пользователя, вошедшего в систему.
Получение частых действий

Извлекает список частых действий пользователя.
Получить профиль

Извлекает данные профиля пользователя.
Получить устройства

Извлекает список устройств Fitbit, подключенных к учетной записи пользователя.
Тип действия Get

Извлекает сведения об одном действии из базы данных действий Fitbit в запрошенном формате. Если это доступно, будут отображаться сведения о уровне действия.

Получение временных рядов действий по дате

Идентификатор операции:
GetActivityTimeSeriesbyDate

Извлекает данные действия для заданного ресурса за период времени, указав дату и период времени. Ответ будет содержать только ежедневные суммарные значения.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Resource
 resource True string

Ресурс возвращаемых данных.
Date
 date True string

Дата окончания периода, указанного в формате гггг-mm-dd
Период
 period True string

Диапазон, для которого будут возвращены данные.

Возвращаемое значение

Имя Путь Тип Описание
действия
 activities-steps array of object

действия
дата и время
 activities-steps.dateTime string

дата и время
value
 activities-steps.value string

value

Получение временных рядов жира тела по дате

Идентификатор операции:
GetBodyFatTimerSeriesbyDate

Извлекает список всех записей журнала жира пользователя за заданный период.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата окончания периода, указанного в формате гггг-mm-dd или сегодня.
Период
 period True string

Диапазон, для которого будут возвращены данные.

Возвращаемое значение

Имя Путь Тип Описание
жир
 fat array of object

жир
date
 fat.date string

Дата записи журнала жира тела.
жир
 fat.fat float

Процент жира тела.
logId
 fat.logId integer

Идентификатор журнала жира тела.
source
 fat.source string

Расположение, в котором возникли данные жира тела. Дополнительные сведения см. в разделе "Исходные" значения.
time
 fat.time string

Метка времени, когда был записан журнал жира тела.

Получение временных рядов по дате

Идентификатор операции:
GetWeightTimeSeriesbyDate

Извлекает список всех записей журнала веса пользователя в течение заданного периода.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата окончания периода, указанного в формате гггг-mm-dd или сегодня.
Период
 period True string

Диапазон, для которого будут возвращены данные.

Возвращаемое значение

Имя Путь Тип Описание
weight
 weight array of object

weight
ИМТ
 weight.bmi float

Вычисляемый BMI в формате X.XX.
date
 weight.date string

Дата записи журнала в формате гггг-mm-dd.
жир
 weight.fat integer

Процент жира тела.
logId
 weight.logId integer

Идентификаторы журналов веса. Это уникально для пользователя, но не глобально уникально.
source
 weight.source string

Источник журнала веса.
time
 weight.time string

Время измерения; часы и минуты в формате HH:mm:ss, установите значение последней секунды дня, если оно не указано.
weight
 weight.weight integer

Вес в формате X.XX в системе единиц, соответствующей указанному заголовку Accept-Language или если он не указан в метрике.

Получение временных рядов тела по дате

Идентификатор операции:
GetBodyTimeSeriesbyDate

Извлекает список всех пользователей bmi, жира тела или веса в течение заданного периода.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Resource
 resource True string

Возвращаемый ресурс основного текста.
Date
 date True string

Дата окончания периода, указанного в формате гггг-mm-dd или сегодня.
Период
 period True string

Диапазон, для которого будут возвращены данные.

Возвращаемое значение

Имя Путь Тип Описание
вес тела
 body-weight array of object

вес тела
дата и время
 body-weight.dateTime string

дата и время
value
 body-weight.value string

value

Получение всех типов действий

Идентификатор операции:
GetAllActivityTypes

Извлекает список всех допустимых общедоступных действий Fitbit и частных действий, созданных пользователем, из базы данных действий Fitbit в запрошенном формате. Если это доступно, будут отображаться сведения о уровне действия.

Возвращаемое значение

Имя Путь Тип Описание
categories
 categories array of object

categories
activities
 categories.activities array of object

activities
accessLevel
 categories.activities.accessLevel string

accessLevel
activityLevels
 categories.activities.activityLevels array of object

activityLevels
id
 categories.activities.activityLevels.id integer

id
maxSpeedMPH
 categories.activities.activityLevels.maxSpeedMPH integer

maxSpeedMPH
Мец
 categories.activities.activityLevels.mets integer

Мец
minSpeedMPH
 categories.activities.activityLevels.minSpeedMPH integer

minSpeedMPH
имя
 categories.activities.activityLevels.name string

имя
hasSpeed
 categories.activities.hasSpeed boolean

hasSpeed
id
 categories.activities.id integer

id
имя
 categories.activities.name string

имя
Мец
 categories.activities.mets float

Мец

Получение действия TCX

Идентификатор операции:
GetActivityTCX

XML-код Центра обучения (TCX) — это формат обмена данными, содержащий данные GPS, частоты пульса и lap. Эта конечная точка извлекает сведения о расположении пользователя с помощью данных GPS и частоты пульса во время зарегистрированного упражнения.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор использования
Идентификатор журнала
 log-id True string

Идентификатор журнала действия.
Частичный TCX
 includePartialTCX boolean

Включает точки TCX, когда данные GPS недоступны.

Получение журнала веса

Идентификатор операции:
GetWeightLog

Извлекает список всех записей журнала веса пользователя для заданной даты.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата в формате гггг-mm-dd

Возвращаемое значение

Имя Путь Тип Описание
weight
 weight array of object

weight
ИМТ
 weight.bmi float

Вычисляемый BMI в формате X.XX
date
 weight.date string

Дата записи журнала в формате гггг-mm-dd.
жир
 weight.fat integer
logId
 weight.logId integer

Идентификаторы журналов веса уникальны для пользователя, но не глобально уникальны.
source
 weight.source string

source
time
 weight.time string

Время измерения; часы и минуты в формате HH:mm:ss, установите значение последней секунды дня, если оно не указано.
weight
 weight.weight integer

Вес в формате X.XX в системе единиц, соответствующей указанному заголовку Accept-Language или если он не указан в метрике.

Получение журнала жира тела

Идентификатор операции:
GetBodyFattLog

Извлекает список всех записей журнала жира пользователя для заданной даты.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата в формате гггг-mm-dd.

Возвращаемое значение

Имя Путь Тип Описание
жир
 fat array of object

жир
date
 fat.date string

Дата записи журнала жира тела.
жир
 fat.fat integer

Процент жира тела.
logId
 fat.logId integer

Идентификатор журнала жира тела.
source
 fat.source string

Расположение, в котором возникли данные жира тела.
time
 fat.time string

Метка времени, когда был записан журнал жира тела.

Получение журнала спящего режима по дате

Идентификатор операции:
GetSleepLogbyDate

Возвращает список записей журнала спящего режима пользователя для заданной даты.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

гггг-мм-дд

Возвращаемое значение

Имя Путь Тип Описание
sleep
 sleep array of object

sleep
dateOfSleep
 sleep.dateOfSleep string

Дата окончания журнала спящего режима
duration
 sleep.duration integer

Длина сна в миллисекундах.
эффективность
 sleep.efficiency integer

Вычисляемая оценка эффективности сна. Это не оценка сна, доступная в мобильном приложении.
endTime
 sleep.endTime string

Время окончания журнала спящего режима.
infoCode
 sleep.infoCode integer

Целочисленное значение, представляющее качество данных, собранных в журнале спящего режима. 0 = достаточные данные для создания журнала спящего режима. 1 = недостаточно данных частоты пульса. 2 = период сна был слишком коротким (менее 3 часов). 3 = проблема на стороне сервера.
isMainSleep
 sleep.isMainSleep boolean

Boolean
данные
 sleep.levels.data array of object

данные
дата и время
 sleep.levels.data.dateTime string

дата и время
уровень
 sleep.levels.data.level string

уровень
товары второго сорта
 sleep.levels.data.seconds integer

товары второго сорта
shortData
 sleep.levels.shortData array of object

shortData
дата и время
 sleep.levels.shortData.dateTime string

дата и время
уровень
 sleep.levels.shortData.level string

уровень
товары второго сорта
 sleep.levels.shortData.seconds integer

товары второго сорта
count
 sleep.levels.summary.deep.count integer

count
протокол
 sleep.levels.summary.deep.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.deep.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.light.count integer

count
протокол
 sleep.levels.summary.light.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.light.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.rem.count integer

count
протокол
 sleep.levels.summary.rem.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.rem.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.wake.count integer

count
протокол
 sleep.levels.summary.wake.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.wake.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
logId
 sleep.logId integer

Идентификатор журнала спящего режима.
minutesAfterWakeup
 sleep.minutesAfterWakeup integer

Общее количество минут после того, как пользователь проснулся.
minutesAsleep
 sleep.minutesAsleep integer

Общее количество минут, за которые пользователь спал.
Минута пробуждения
 sleep.minutesAwake integer

Общая сумма минут пробуждения. Он не включается перед заснение или после пробуждения.
minutesToFallAsleep
 sleep.minutesToFallAsleep integer

Общее количество минут до того, как пользователь заснет. Обычно это значение равно 0 для журналов автоматического спящего режима.
logType
 sleep.logType string

auto_detected | Вручную
startTime
 sleep.startTime string

Время начала журнала спящего режима.
timeInBed
 sleep.timeInBed integer

Общее количество минут, в течение которых пользователь был в кровати.
type
 sleep.type string

классическая | Этапах
глубокий
 summary.stages.deep integer

глубокий
свет
 summary.stages.light integer

свет
rem
 summary.stages.rem integer

rem
будить
 summary.stages.wake integer

будить
totalMinutesAsleep
 summary.totalMinutesAsleep integer

Общее количество минут, за которые пользователь спал во всех записях спящего режима в журнале спящего режима.
totalSleepRecords
 summary.totalSleepRecords integer

Количество записей спящего режима в журнале спящего режима.
totalTimeInBed
 summary.totalTimeInBed integer

Общее количество минут, в течение которых пользователь был в постели во всех записях в журнале сна.

Получение журнала спящего режима по диапазону дат

Идентификатор операции:
GetSleepLogbyDateRange

Возвращает список записей журнала спящего режима пользователя для диапазона дат.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Дата начала
 startDate True string

Дата возврата первого журнала спящего режима (гггг-mm-dd)
Дата окончания
 endDate True string

Дата возврата последнего журнала спящего режима (гггг-mm-dd)

Возвращаемое значение

Имя Путь Тип Описание
sleep
 sleep array of object

sleep
dateOfSleep
 sleep.dateOfSleep string

Дата окончания журнала спящего режима.
duration
 sleep.duration integer

Длина сна в миллисекундах.
эффективность
 sleep.efficiency integer

Вычисляемая оценка эффективности сна. Это не оценка сна, доступная в мобильном приложении.
endTime
 sleep.endTime string

Время окончания журнала спящего режима.
infoCode
 sleep.infoCode integer

Целочисленное значение, представляющее качество данных, собранных в журнале спящего режима. 0 = достаточные данные для создания журнала спящего режима. 1 = недостаточно данных частоты пульса. 2 = период сна был слишком коротким (менее 3 часов). 3 = проблема на стороне сервера.
isMainSleep
 sleep.isMainSleep boolean

Boolean
данные
 sleep.levels.data array of object

данные
дата и время
 sleep.levels.data.dateTime string

дата и время
уровень
 sleep.levels.data.level string

уровень
товары второго сорта
 sleep.levels.data.seconds integer

товары второго сорта
count
 sleep.levels.summary.asleep.count integer

count
протокол
 sleep.levels.summary.asleep.minutes integer

протокол
count
 sleep.levels.summary.awake.count integer

count
протокол
 sleep.levels.summary.awake.minutes integer

протокол
count
 sleep.levels.summary.restless.count integer

count
протокол
 sleep.levels.summary.restless.minutes integer

протокол
count
 sleep.levels.summary.deep.count integer

count
протокол
 sleep.levels.summary.deep.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.deep.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.light.count integer

count
протокол
 sleep.levels.summary.light.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.light.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.rem.count integer

count
протокол
 sleep.levels.summary.rem.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.rem.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.wake.count integer

count
протокол
 sleep.levels.summary.wake.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.wake.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
shortData
 sleep.levels.shortData array of object

shortData
дата и время
 sleep.levels.shortData.dateTime string

дата и время
уровень
 sleep.levels.shortData.level string

уровень
товары второго сорта
 sleep.levels.shortData.seconds integer

товары второго сорта
logId
 sleep.logId integer

Идентификатор журнала спящего режима.
minutesAfterWakeup
 sleep.minutesAfterWakeup integer

Общее количество минут после того, как пользователь проснулся.
minutesAsleep
 sleep.minutesAsleep integer

Общее количество минут, за которые пользователь спал.
Минута пробуждения
 sleep.minutesAwake integer

Общая сумма минут пробуждения. Он не включается перед заснение или после пробуждения.
minutesToFallAsleep
 sleep.minutesToFallAsleep integer

Общее количество минут до того, как пользователь заснет. Обычно это значение равно 0 для журналов автоматического спящего режима.
logType
 sleep.logType string

auto_detected | Вручную
startTime
 sleep.startTime string

Время начала журнала спящего режима
timeInBed
 sleep.timeInBed integer

Общее количество минут, в течение которых пользователь был в постели
type
 sleep.type string

классическая | Этапах

Получение значков

Идентификатор операции:
GetBadges

Извлекает список индикаторов событий пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
Значки
 badges array of object

Значки
badgeGradientEndColor
 badges.badgeGradientEndColor string

badgeGradientEndColor
badgeGradientStartColor
 badges.badgeGradientStartColor string

badgeGradientStartColor
badgeType
 badges.badgeType string

Тип полученного значка.
категория
 badges.category string

категория
аплодисменты
 badges.cheers array of

аплодисменты
дата и время
 badges.dateTime string

Дата достижения значка.
описание
 badges.description string

описание
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
имя
 badges.name string

имя
shareImage640px
 badges.shareImage640px string

shareImage640px
shareText
 badges.shareText string

shareText
краткое описание
 badges.shortDescription string

краткое описание
shortName
 badges.shortName string

shortName
timesAchieved
 badges.timesAchieved integer

Количество попыток достижения значка пользователем.
value
 badges.value integer

Цель значка в измерении единицы измерения.

Получение избранных действий

Идентификатор операции:
GetFavoriteActivities

Извлекает список любимых действий пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
array of object
activityId
 activityId integer

Номер идентификатора записанного действия.
описание
 description string

Дополнительные сведения о записанной активности.
Мец
 mets integer

Метаболическое эквивалент (METS) выполняемого действия.
имя
 name string

Имя записанного действия.

Получение максимальной сводки по дате VO2

Идентификатор операции:
GetVO2MaxSummarybyDate

Возвращает данные о сердечно-фитнес-оценке (также известной как VO2 Max) для одной даты. Значения VO2 Max будут отображаться в виде диапазона, если данные о выполнении недоступны или одно числовое значение, если пользователь использует GPS для выполнения. Дополнительные сведения см. в разделе "Дополнительные сведения" для дальнейшего контекста.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата в формате гггг-mm-dd или сегодня.

Возвращаемое значение

Имя Путь Тип Описание
cardioScore
 cardioScore array of object

cardioScore
дата и время
 cardioScore.dateTime string

Дата, указанная в формате ГГГГ-ММ-ДД.
vo2Max
 cardioScore.value.vo2Max string

Отображаемое значение VO2 Max в mL/kg/min

Получение оповещений

Идентификатор операции:
GetAlarms

Извлекает оповещения, включенные для определенного устройства.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Идентификатор трекера
 tracker-id True string

Идентификатор средства отслеживания, для которого возвращаются данные.

Возвращаемое значение

Имя Путь Тип Описание
trackerAlarms
 trackerAlarms array of object

trackerAlarms
alarmId
 trackerAlarms.alarmId integer

Числовое значение, представляющее идентификатор сигнализации.
удалено
 trackerAlarms.deleted boolean

Указывает, удалена ли сигнализация.
enabled
 trackerAlarms.enabled boolean

Указывает, включена ли сигнализация.
повторяющийся
 trackerAlarms.recurring boolean

Указывает, повторяется ли тревога.
snoozeCount
 trackerAlarms.snoozeCount integer

Указывает количество раз, когда тревога будет отложена.
snoozeLength
 trackerAlarms.snoozeLength integer

Указывает время в минутах между периодами отложений.
syncedToDevice
 trackerAlarms.syncedToDevice boolean

true | ложный
time
 trackerAlarms.time string

Смещение времени и времени в формате UTC для указанной сигнализации.
Атмосфера
 trackerAlarms.vibe string

Возвращает тип настроенной вибрации.
weekDays
 trackerAlarms.weekDays array of string

weekDays

Получение последних типов действий

Идентификатор операции:
GetRecentActivityTypes

Извлекает список последних типов действий пользователя, зарегистрированных с некоторыми сведениями о последнем журнале действий этого типа.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
array of object
activityId
 activityId integer

Числовый идентификатор действия или упражнения.
калории
 calories integer

Количество калорий, сожженных во время записанной активности.
описание
 description string

Сведения, если они доступны, о действии или упражнении.
distance
 distance integer

Расстояние перемещается во время записанного действия.
duration
 duration integer

Время (миллисекунда) для завершения записанного действия.
имя
 name string

Имя действия или упражнения.

Получение сводки по дате HRV

Идентификатор операции:
GetHRVSummarybyDate

Эта конечная точка возвращает данные о частоте пульса (HRV) для одной даты

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата в формате гггг-ММ-дд или сегодня.

Возвращаемое значение

Имя Путь Тип Описание
hrv
 hrv array of object

hrv
dailyRmssd
 hrv.value.dailyRmssd float

Корневой средний квадрат последовательных различий (RMSSD) между сердцем бьет. Он измеряет краткосрочную дисперсию в ежедневном частоте пульса пользователя в миллисекундах (мс).
deepRmssd
 hrv.value.deepRmssd float

Корневой средний квадрат последовательных различий (RMSSD) между сердцем бьет. Он измеряет краткосрочную дисперсию в частоте пульса пользователя в то время как в глубоком спячем, в миллисекундах (мс).
дата и время
 hrv.dateTime string

Дата журнала спящего режима, указанная в формате ГГГГ-ММ-ДД.

Получение сводки по ежедневным действиям

Идентификатор операции:
GetDailyActivitySummary

Извлекает сводку и список действий пользователя и записей журнала действий в течение определенного дня.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Date

Возвращаемое значение

Имя Путь Тип Описание
activities
 activities array of

activities
activeMinutes
 goals.activeMinutes integer

activeMinutes
калорий
 goals.caloriesOut integer

калорий
distance
 goals.distance float

distance
Полом
 goals.floors integer

Полом
steps
 goals.steps integer

steps
activeScore
 summary.activeScore integer

activeScore
activityCalories
 summary.activityCalories integer

activityCalories
калорияEstimationMu
 summary.calorieEstimationMu integer

калорияEstimationMu
калорииBMR
 summary.caloriesBMR integer

калорииBMR
калорий
 summary.caloriesOut integer

калорий
калорийOutUnestimated
 summary.caloriesOutUnestimated integer

калорийOutUnestimated
customHeartRateZones
 summary.customHeartRateZones array of object

customHeartRateZones
калорий
 summary.customHeartRateZones.caloriesOut integer

калорий
max
 summary.customHeartRateZones.max integer

max
min
 summary.customHeartRateZones.min integer

min
протокол
 summary.customHeartRateZones.minutes integer

протокол
имя
 summary.customHeartRateZones.name string

имя
Расстояния
 summary.distances array of object

Расстояния
активность
 summary.distances.activity string

<имя> действия | total | tracker | loggedActivities | veryActive | moderatelyActive | lightlyActive | sedentaryActive
distance
 summary.distances.distance integer

Для указанного ресурса расстояние, указанное в течение дня, отображаемое в единицах, определенных заголовком Accept-Language.
возвышенность
 summary.elevation integer

Повышение прав, перемещаемое на день, отображаемое в единицах, определенных заголовком Accept-Language.
fairlyActiveMinutes
 summary.fairlyActiveMinutes integer

Всего минут, когда пользователь был достаточно или умеренно активен.
Полом
 summary.floors integer

Эквивалентные полы поднялись на день, отображаемые в единицах, определенных Accept-Language заголовком.
heartRateZones
 summary.heartRateZones array of object

heartRateZones
калорий
 summary.heartRateZones.caloriesOut integer

калорий
max
 summary.heartRateZones.max integer

max
min
 summary.heartRateZones.min integer

min
протокол
 summary.heartRateZones.minutes integer

протокол
имя
 summary.heartRateZones.name string

Область пульса требуется для просмотра этого значения. Вне диапазона | Жировые ожоги | Кардио | Пик
lightlyActiveMinutes
 summary.lightlyActiveMinutes integer

Всего минут, когда пользователь был легко активен.
маргинальные калории
 summary.marginalCalories integer

Всего маргинальных оценочных калорий, сожженных в течение дня.
restingHeartRate
 summary.restingHeartRate integer

Область пульса требуется для просмотра этого значения.
sedentaryMinutes
 summary.sedentaryMinutes integer

Всего минут, когда пользователь был отступным.
steps
 summary.steps integer

Всего шагов, выполненных в течение дня.
useEstimation
 summary.useEstimation boolean

Логическое значение, указывающее, используются ли оценки в вычислениях.
veryActiveMinutes
 summary.veryActiveMinutes integer

Всего минут, когда пользователь был очень активным.

Получение сводки по частоте дыхания по дате

Идентификатор операции:
GetBreathingRateSummarybyDate

Эта конечная точка возвращает данные средней скорости дыхания для одной даты. Данные частоты дыхания применяются специально к "главному спячному" пользователю, который является самым длинным периодом времени, в течение которого они заснули на заданной дате.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Date
 date True string

Дата в формате гггг-mm-dd или сегодня.

Возвращаемое значение

Имя Путь Тип Описание
br
 br array of object

br
дыханиеRate
 br.value.breathingRate float

Среднее количество вдохов, принятых в минуту.
дата и время
 br.dateTime string

Дата журнала спящего режима, указанная в формате ГГГГ-ММ-ДД.

Получение списка журналов действий

Идентификатор операции:
GetActivityLogList

Извлекает список записей журнала действий пользователя до или после заданного дня.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
После даты
 afterDate string

Дата окончания (гггг-mm-dd)
До даты
 beforeDate string

Дата до (гггг-mm-dd)
Сортировать
 sort string

Порядок сортировки записей по дате.
Лимит
 limit integer

Количество возвращенных записей.

Возвращаемое значение

Имя Путь Тип Описание
activities
 activities array of object

activities
activeDuration
 activities.activeDuration integer

Время (миллисекунда) в каждом действииLevel.
activityLevel
 activities.activityLevel array of object

activityLevel
протокол
 activities.activityLevel.minutes integer

протокол
имя
 activities.activityLevel.name string

имя
activityName
 activities.activityName string

Имя записанного упражнения.
activityTypeId
 activities.activityTypeId integer

Номер идентификатора activityName.
калории
 activities.calories integer

Количество калорий, сожженных во время упражнения.
калорииLink
 activities.caloriesLink string

Конечная точка веб-API для вызова для получения определенных калорий, сожженных для именованного упражнения.
duration
 activities.duration integer

Длина времени (миллисекунда) после изменения упражнения. Если упражнение не было изменено, длительность = originalDuration. Это значение будет содержать паузы во время упражнения.
elevationGain
 activities.elevationGain float

Повышение, полученное во время упражнения.
последнееИзменение
 activities.lastModified string

Метка времени последнего изменения упражнения.
logId
 activities.logId integer

Идентификатор журнала действий для упражнения.
logType
 activities.logType string

auto_detected | вручную | mobile_run | трекер | Имя стороннего приложения
калории
 activities.manualValuesSpecified.calories boolean

Логическое значение, указывающее, были ли калорийы предоставлены при записи упражнения.
distance
 activities.manualValuesSpecified.distance boolean

Логическое значение, указывающее, было ли указано расстояние при записи упражнения.
steps
 activities.manualValuesSpecified.steps boolean

Логическое значение, указывающее, были ли предоставлены шаги при записи упражнения.
originalDuration
 activities.originalDuration integer

Начальная длина времени (миллисекунда), записанная упражнением. Это значение будет содержать паузы во время упражнения.
originalStartTime
 activities.originalStartTime string

Начальная дата начала, записанная упражнением.
startTime
 activities.startTime string

Дата начала после изменения упражнения. Если упражнение не было изменено, startTime = originalStartTime.
steps
 activities.steps integer

Количество шагов, выполненных во время упражнения.
tcxLink
 activities.tcxLink string

URL-адрес для скачивания файла TCX.
afterDate
 pagination.afterDate string

afterDate
limit
 pagination.limit integer

limit
next
 pagination.next string

next
offset
 pagination.offset integer

offset
предыдущий
 pagination.previous string

предыдущий
sort
 pagination.sort string

sort

Получение списка журналов спящего режима

Идентификатор операции:
GetSleepLogList

Возвращает список записей журнала спящего режима пользователя до или после заданной даты

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
После даты
 afterDate string

После даты возврата журнала спящего режима пользователя (гггг-mm-dd)
До даты
 beforeDate string

До даты возврата журнала спящего режима пользователя (гггг-mm-dd)
Сортировать
 sort string

возрастание или убывание
Лимит
 limit integer

Количество возвращаемых журналов спящего режима. (максимум 100)

Возвращаемое значение

Имя Путь Тип Описание
afterDate
 pagination.afterDate string

afterDate
limit
 pagination.limit integer

limit
next
 pagination.next string

next
offset
 pagination.offset integer

offset
предыдущий
 pagination.previous string

предыдущий
sort
 pagination.sort string

sort
sleep
 sleep array of object

sleep
dateOfSleep
 sleep.dateOfSleep string
duration
 sleep.duration integer

duration
эффективность
 sleep.efficiency integer

эффективность
endTime
 sleep.endTime string

endTime
infoCode
 sleep.infoCode integer

infoCode
isMainSleep
 sleep.isMainSleep boolean

isMainSleep
данные
 sleep.levels.data array of object

данные
дата и время
 sleep.levels.data.dateTime string

дата и время
уровень
 sleep.levels.data.level string

уровень
товары второго сорта
 sleep.levels.data.seconds integer

товары второго сорта
shortData
 sleep.levels.shortData array of object

shortData
дата и время
 sleep.levels.shortData.dateTime string

дата и время
уровень
 sleep.levels.shortData.level string

уровень
товары второго сорта
 sleep.levels.shortData.seconds integer

товары второго сорта
count
 sleep.levels.summary.deep.count integer

count
протокол
 sleep.levels.summary.deep.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.deep.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.light.count integer

count
протокол
 sleep.levels.summary.light.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.light.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.rem.count integer

count
протокол
 sleep.levels.summary.rem.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.rem.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
count
 sleep.levels.summary.wake.count integer

count
протокол
 sleep.levels.summary.wake.minutes integer

протокол
тридцатьDayAvgMinutes
 sleep.levels.summary.wake.thirtyDayAvgMinutes integer

тридцатьDayAvgMinutes
logId
 sleep.logId integer

logId
logType
 sleep.logType string

logType
minutesAfterWakeup
 sleep.minutesAfterWakeup integer

minutesAfterWakeup
minutesAsleep
 sleep.minutesAsleep integer

minutesAsleep
Минута пробуждения
 sleep.minutesAwake integer

Минута пробуждения
minutesToFallAsleep
 sleep.minutesToFallAsleep integer

minutesToFallAsleep
startTime
 sleep.startTime string

startTime
timeInBed
 sleep.timeInBed integer

timeInBed
type
 sleep.type string

type

Получение списка лидеров друзей

Идентификатор операции:
GetFriendsLeaderboard

Эта конечная точка возвращает другую доску лидеров пользователя

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
данные
 data array of object

данные
type
 data.type string

type
id
 data.id string

id
шаг-ранж
 data.attributes.step-rank integer

Ранжирование среди друзей пользователя.
сводка по шагу
 data.attributes.step-summary integer

Еженедельное число шагов.
type
 data.relationships.user.data.type string

type
id
 data.relationships.user.data.id string

id
включенный
 included array of object

включенный
type
 included.type string

type
id
 included.id string

id
аватар
 included.attributes.avatar string

Ссылка на аватар пользователя.
child
 included.attributes.child boolean

child
друг
 included.attributes.friend boolean

друг
имя
 included.attributes.name string

имя

Получение статистики времени существования

Идентификатор операции:
GetLifetimeStats

Извлекает статистику действий пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
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
калорий
 lifetime.total.caloriesOut integer

калорий
distance
 lifetime.total.distance float

distance
Полом
 lifetime.total.floors integer

Полом
steps
 lifetime.total.steps integer

steps
activeScore
 lifetime.tracker.activeScore integer

activeScore
калорий
 lifetime.tracker.caloriesOut integer

калорий
distance
 lifetime.tracker.distance float

distance
Полом
 lifetime.tracker.floors integer

Полом
steps
 lifetime.tracker.steps integer

steps

Получение целей действий

Идентификатор операции:
GetActivityGoals

Извлекает текущие или еженедельные цели действий пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Период
 period True string

ежедневно| еженедельный

Возвращаемое значение

Имя Путь Тип Описание
activeMinutes
 goals.activeMinutes integer

Ежедневные активные минуты цели. Значение не возвращается для еженедельных целей.
activeZoneMinutes
 goals.activeZoneMinutes integer

Ежедневные или еженедельные минуты активной зоны.
калорий
 goals.caloriesOut integer

Ежедневные калории сожгли цель. Значение не возвращается для еженедельных целей.
distance
 goals.distance float

Ежедневные или еженедельные цели расстояния.
Полом
 goals.floors integer

Ежедневно или еженедельно полы поднялись цели.
steps
 goals.steps integer

Ежедневные или еженедельные шаги, сделанные целью.

Получение целей тела

Идентификатор операции:
GetBodyGoals

Извлекает жир тела пользователя и цели веса.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Тип цели
 goal-type True string

Тип цели

Возвращаемое значение

Имя Путь Тип Описание
goalType
 goal.goalType string
startDate
 goal.startDate string

Дата начала цели.
startWeight
 goal.startWeight float

Вес пользователя при установке цели.
weight
 goal.weight float

Цель достижения веса.
weightThreshold
 goal.weightThreshold float

Рекомендуемое количество веса, чтобы потерять каждую неделю для достижения и поддержания цели.

Получение цели сна

Идентификатор операции:
GetSleepGoal

Укажите кодированный идентификатор пользователя. Используйте "-" (dash) для текущего пользователя, вошедшего в систему.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
flowId
 consistency.flowId integer

0 = задана цель сна, но не хватает записываемых журналов сна. 1 = пользователь либо пропустил цель сна, либо нет цели, но есть достаточно журналов сна, записанных. 2 = цель сна не задана, и нет достаточно журналов сна, записанных. 3 = пользователь достиг своей цели сна
minDuration
 goal.minDuration integer

Длина периода цели сна в минутах.
updatedOn
 goal.updatedOn string

Метка времени, которую была создана или обновлена цель.

Получение частых действий

Идентификатор операции:
GetFrequentActivities

Извлекает список частых действий пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
array of object
activityId
 activityId integer

Номер идентификатора записанного действия.
калории
 calories integer

Количество калорий, сожженных, связанных с действием.
описание
 description string

Дополнительные сведения о записанной активности.
distance
 distance integer

Расстояние, связанное с записанным действием.
duration
 duration integer

Длина времени (миллисекунда) после изменения упражнения. Это значение будет содержать паузы во время упражнения.
имя
 name string

Имя записанного действия.

Получить профиль

Идентификатор операции:
GetProfile

Извлекает данные профиля пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
aboutMe;
 user.aboutMe string

Сведения "О мне", указанные в параметрах учетной записи пользователя.
возраст
 user.age string

Возраст на основе указанного дня рождения в параметрах учетной записи пользователя.
посол
 user.ambassador string

посол
autoStrideEnabled
 user.autoStrideEnabled string

autoStrideEnabled
аватар
 user.avatar string

аватар
аватар150
 user.avatar150 string

аватар150
аватар640
 user.avatar640 string

аватар640
averageDailySteps
 user.averageDailySteps string

Средние ежедневные шаги, вычисляемые для пользователя.
challengesBeta
 user.challengesBeta string

challengesBeta
clockTimeDisplayFormat
 user.clockTimeDisplayFormat string

clockTimeDisplayFormat
country
 user.country string

country
корпоративный
 user.corporate string

корпоративный
corporateAdmin
 user.corporateAdmin string

corporateAdmin
dateOfBirth
 user.dateOfBirth string

dateOfBirth
отображаемое имя
 user.displayName string

отображаемое имя
displayNameSetting
 user.displayNameSetting string

displayNameSetting
единица измерения расстояния
 user.distanceUnit string

единица измерения расстояния
encodedId
 user.encodedId string

encodedId
упражнениеGoal
 user.features.exerciseGoal string

упражнениеGoal
Имя
 user.firstName string

Имя
foodsLocale
 user.foodsLocale string

foodsLocale
fullName
 user.fullName string

fullName
gender
 user.gender string

gender
глюкозаUnit
 user.glucoseUnit string

глюкозаUnit
height
 user.height string

Значение высоты, указанное в параметрах учетной записи пользователя.
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
местность
 user.locale string

местность
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
государство
 user.state string

государство
strideLengthRunning
 user.strideLengthRunning string

strideLengthRunning
strideLengthRunningType
 user.strideLengthRunningType string

strideLengthRunningType
strideLengthWalking
 user.strideLengthWalking string

strideLengthWalking
strideLengthWalkingType
 user.strideLengthWalkingType string

strideLengthWalkingType
swimUnit
 user.swimUnit string

swimUnit
temperatureUnit
 user.temperatureUnit string

temperatureUnit
timezone
 user.timezone string

timezone
topBadges
 user.topBadges string

Массив, в котором перечислены эмблемы Fitbit, полученные пользователем.
waterUnit
 user.waterUnit string

waterUnit
waterUnitName
 user.waterUnitName string

waterUnitName
weight
 user.weight string

weight
единица веса
 user.weightUnit string

единица веса

Получить устройства

Идентификатор операции:
GetDevices

Извлекает список устройств Fitbit, подключенных к учетной записи пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя

Возвращаемое значение

Имя Путь Тип Описание
array of object
батарея
 battery string

Возвращает уровень заряда батареи устройства
batteryLevel
 batteryLevel integer

Возвращает процент заряда батареи устройства.
deviceVersion
 deviceVersion string

Имя продукта устройства.
features
 features array of

features
id
 id string

Идентификатор устройства.
lastSyncTime
 lastSyncTime string

Метка времени, представляющая последний раз, когда устройство было синхронизировано с мобильным приложением Fitbit.
mac
 mac string

Номер идентификатора Mac
type
 type string

TRACKER | ШКАЛА

Тип действия Get

Идентификатор операции:
GetAcitivityType

Извлекает сведения об одном действии из базы данных действий Fitbit в запрошенном формате. Если это доступно, будут отображаться сведения о уровне действия.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user-id True string

Кодированный идентификатор пользователя
Идентификатор действия
 activity-id True string

Идентификатор действия

Возвращаемое значение

Имя Путь Тип Описание
accessLevel
 activity.accessLevel string

PUBLIC | ЧАСТНЫЙ
activityLevels
 activity.activityLevels array of object

activityLevels
id
 activity.activityLevels.id integer

Числовое значение, представляющее соответствующий уровень действия.
maxSpeedMPH
 activity.activityLevels.maxSpeedMPH float

Максимальная скорость в MPH. Значение: -1 означает, что не применимо.
Мец
 activity.activityLevels.mets integer

Оценка метаданных для идентификатора действия.
minSpeedMPH
 activity.activityLevels.minSpeedMPH integer

Минимальная скорость в MPH. Значение: -1 означает, что не применимо.
имя
 activity.activityLevels.name string

Имя уровня действия.
hasSpeed
 activity.hasSpeed boolean

true | ложный
id
 activity.id integer

Числовое значение, представляющее соответствующее действие.
имя
 activity.name string

Имя действия или упражнения.