Compartir a través de


Fitbit (Publicador independiente) (versión preliminar)

Una manera de acceder a la API web de Fitbit

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Ashwin Ganesh Kumar
URL https://www.blisdigital.com/
Correo Electrónico a.kumar@blisdigital.com
Metadatos del conector
Publicador Ashwin Ganesh Kumar
Sitio web https://dev.fitbit.com//
Directiva de privacidad https://www.fitbit.com/global/nl/legal/privacy-policy
Categorías Data

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Obtener actividad TCX

El XML del Centro de entrenamiento (TCX) es un formato de intercambio de datos que contiene datos gps, frecuencia cardíaca y vuelta. Este punto de conexión recupera los detalles de la ubicación de un usuario mediante gps y datos de frecuencia cardíaca durante un ejercicio registrado.

Obtener actividades favoritas

Recupera una lista de las actividades favoritas de un usuario.

Obtener actividades frecuentes

Recupera una lista de las actividades frecuentes de un usuario.

Obtener alarmas

Recupera las alarmas habilitadas para un dispositivo específico.

Obtener dispositivos

Recupera una lista de dispositivos de Fitbit emparejados con la cuenta de un usuario.

Obtener distintivos

Recupera una lista de distintivos del usuario.

Obtener el objetivo de suspensión

Especifique el identificador codificado del usuario. Use "-" (guión) para el usuario que ha iniciado sesión.

Obtener estadísticas de duración

Recupera las estadísticas de actividad del usuario.

Obtener lista de registros de actividad

Recupera una lista de entradas del registro de actividad de un usuario antes o después de un día determinado.

Obtener lista de registros de suspensión

Devuelve una lista de las entradas del registro de suspensión de un usuario antes o después de una fecha determinada.

Obtener objetivos corporales

Recupera los objetivos de grasa corporal y peso de un usuario.

Obtener objetivos de actividad

Recupera los objetivos actuales de actividad diaria o semanal de un usuario.

Obtener perfil

Recupera los datos del perfil del usuario.

Obtener registro de grasa corporal

Recupera una lista de todas las entradas del registro de grasa corporal del usuario para una fecha determinada.

Obtener registro de peso

Recupera una lista de todas las entradas del registro de peso del usuario para una fecha determinada.

Obtener registro de suspensión por fecha

Devuelve una lista de las entradas del registro de suspensión de un usuario para una fecha determinada.

Obtener registro de suspensión por intervalo de fechas

Devuelve una lista de las entradas del registro de suspensión de un usuario para un intervalo de fechas.

Obtener resumen de actividad diaria

Recupera un resumen y una lista de las entradas del registro de actividad y las actividades de un usuario durante un día determinado.

Obtener resumen de frecuencia de respiración por fecha

Este punto de conexión devuelve el promedio de datos de frecuencia de respiración para una sola fecha. Los datos de frecuencia de respiración se aplican específicamente a la "suspensión principal" de un usuario, que es el período de tiempo más largo durante el cual estaban dormidos en una fecha determinada.

Obtener resumen de HRV por fecha

Este punto de conexión devuelve los datos de variabilidad de frecuencia cardíaca (HRV) para una sola fecha.

Obtener resumen máximo de VO2 por fecha

Devuelve los datos de La puntuación de fitness cardio (también conocido como VO2 Max) para una sola fecha. Los valores máximos vo2 se mostrarán como un intervalo si no hay datos de ejecución disponibles o un valor numérico único si el usuario usa un GPS para las ejecuciones. Consulte Información adicional para obtener más contexto.

Obtener serie temporal de grasa corporal por fecha

Recupera una lista de todas las entradas del registro de grasa corporal del usuario durante un período determinado.

Obtener serie temporal del cuerpo por fecha

Recupera una lista del peso, la grasa corporal o el peso de todos los usuarios durante un período determinado.

Obtener series temporales de actividad por fecha

Recupera los datos de actividad de un recurso determinado durante un período de tiempo especificando una fecha y un período de tiempo. La respuesta incluirá solo los valores de resumen diarios.

Obtener series temporales de peso por fecha

Recupera una lista de todas las entradas del registro de peso del usuario durante un período determinado.

Obtener tabla de clasificación de amigos

Este punto de conexión devuelve la tabla de clasificación de confianza del usuario.

Obtener tipo de actividad

Recupera los detalles de una sola actividad de la base de datos de actividades de Fitbit en el formato solicitado. Si está disponible, se mostrarán los detalles del nivel de actividad.

Obtener tipos de actividad recientes

Recupera una lista de los tipos de actividades recientes de un usuario registrados con algunos detalles del último registro de actividad de ese tipo.

Obtener todos los tipos de actividad

Recupera una lista de todas las actividades públicas de Fitbit válidas y las actividades privadas creadas por el usuario de la base de datos de actividades de Fitbit en el formato solicitado. Si está disponible, se mostrarán los detalles del nivel de actividad.

Obtener actividad TCX

El XML del Centro de entrenamiento (TCX) es un formato de intercambio de datos que contiene datos gps, frecuencia cardíaca y vuelta. Este punto de conexión recupera los detalles de la ubicación de un usuario mediante gps y datos de frecuencia cardíaca durante un ejercicio registrado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del uso

Identificador de registro
log-id True string

Identificador de registro de la actividad.

TCX parcial
includePartialTCX boolean

Incluye los puntos TCX cuando los datos GPS no están disponibles.

Obtener actividades favoritas

Recupera una lista de las actividades favoritas de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
activityId
activityId integer

Número de identificador de la actividad registrada.

descripción
description string

Información adicional sobre la actividad registrada.

Mets
mets integer

Equivalente metabolismo (MET) de la actividad realizada.

nombre
name string

Nombre de la actividad registrada.

Obtener actividades frecuentes

Recupera una lista de las actividades frecuentes de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
activityId
activityId integer

Número de identificador de la actividad registrada.

calorías
calories integer

Número de calorías quemadas asociadas a la actividad.

descripción
description string

Información adicional sobre la actividad registrada.

distance
distance integer

Distancia viaja asociada a la actividad registrada.

duration
duration integer

El período de tiempo (milisegundos) después de editar el ejercicio. Este valor contendrá pausas durante el ejercicio.

nombre
name string

Nombre de la actividad registrada.

Obtener alarmas

Recupera las alarmas habilitadas para un dispositivo específico.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Identificador de seguimiento
tracker-id True string

Identificador del rastreador para el que se devuelven los datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
trackerAlarms
trackerAlarms array of object

trackerAlarms

alarmId
trackerAlarms.alarmId integer

Valor numérico que representa el identificador de alarma.

eliminado
trackerAlarms.deleted boolean

Indica si se ha eliminado una alarma.

enabled
trackerAlarms.enabled boolean

Indica si está habilitada una alarma.

recurrente
trackerAlarms.recurring boolean

Indica si una alarma es periódica.

snoozeCount
trackerAlarms.snoozeCount integer

Indica el número de veces que la alarma se pospone.

snoozeLength
trackerAlarms.snoozeLength integer

Indica el tiempo en minutos entre períodos de posponer.

syncedToDevice
trackerAlarms.syncedToDevice boolean

true | falso

time
trackerAlarms.time string

La hora y el desplazamiento UTC de la alarma especificada.

Ambiente
trackerAlarms.vibe string

Devuelve el tipo de vibración configurado.

weekDays
trackerAlarms.weekDays array of string

weekDays

Obtener dispositivos

Recupera una lista de dispositivos de Fitbit emparejados con la cuenta de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
battery
battery string

Devuelve el nivel de batería del dispositivo.

batteryLevel
batteryLevel integer

Devuelve el porcentaje de nivel de batería del dispositivo.

deviceVersion
deviceVersion string

Nombre del producto del dispositivo.

features
features array of

features

id
id string

Identificador del dispositivo.

lastSyncTime
lastSyncTime string

Marca de tiempo que representa la última vez que el dispositivo se sincronizó con la aplicación móvil de Fitbit.

mac
mac string

Número de id. de Mac

type
type string

TRACKER | ESCAMA

Obtener distintivos

Recupera una lista de distintivos del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
Insignias
badges array of object

Insignias

badgeGradientEndColor
badges.badgeGradientEndColor string

badgeGradientEndColor

badgeGradientStartColor
badges.badgeGradientStartColor string

badgeGradientStartColor

badgeType
badges.badgeType string

Tipo de distintivo recibido.

categoría
badges.category string

categoría

Bien
badges.cheers array of

Bien

fechaHora
badges.dateTime string

Fecha en que se alcanzó el distintivo.

descripción
badges.description string

descripción

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

nombre
badges.name string

nombre

shareImage640px
badges.shareImage640px string

shareImage640px

shareText
badges.shareText string

shareText

descripción breve
badges.shortDescription string

descripción breve

shortName
badges.shortName string

shortName

timesAchieved
badges.timesAchieved integer

Número de veces que el usuario ha logrado el distintivo.

value
badges.value integer

Objetivo de distintivo en la medida de la unidad.

Obtener el objetivo de suspensión

Especifique el identificador codificado del usuario. Use "-" (guión) para el usuario que ha iniciado sesión.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
flowId
consistency.flowId integer

0 = Se establece un objetivo de suspensión, pero no hay suficientes registros de suspensión registrados. 1 = El usuario perdió su objetivo de suspensión o no se estableció ningún objetivo, pero hay suficientes registros de suspensión registrados. 2 = No se ha establecido un objetivo de suspensión y no hay suficientes registros de suspensión registrados. 3 = El usuario alcanzó su objetivo de suspensión

minDuration
goal.minDuration integer

Duración del período de objetivo de sueño en minutos.

updatedOn
goal.updatedOn string

Marca de tiempo que el objetivo se creó o actualizó.

Obtener estadísticas de duración

Recupera las estadísticas de actividad del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo 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

caloriesOut
lifetime.total.caloriesOut integer

caloriesOut

distance
lifetime.total.distance float

distance

pisos
lifetime.total.floors integer

pisos

steps
lifetime.total.steps integer

steps

activeScore
lifetime.tracker.activeScore integer

activeScore

caloriesOut
lifetime.tracker.caloriesOut integer

caloriesOut

distance
lifetime.tracker.distance float

distance

pisos
lifetime.tracker.floors integer

pisos

steps
lifetime.tracker.steps integer

steps

Obtener lista de registros de actividad

Recupera una lista de entradas del registro de actividad de un usuario antes o después de un día determinado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Después de la fecha
afterDate string

Fecha posterior (aaaa-mm-dd)

Fecha anterior
beforeDate string

Fecha anterior (aaaa-mm-dd)

Ordenar
sort string

Criterio de ordenación de entradas por fecha.

Limit
limit integer

Número de entradas devueltas.

Devoluciones

Nombre Ruta de acceso Tipo Description
activities
activities array of object

activities

activeDuration
activities.activeDuration integer

Cantidad de tiempo (milisegundos) dentro de cada activityLevel.

activityLevel
activities.activityLevel array of object

activityLevel

minutes
activities.activityLevel.minutes integer

minutes

nombre
activities.activityLevel.name string

nombre

activityName
activities.activityName string

Nombre del ejercicio registrado.

activityTypeId
activities.activityTypeId integer

Número de identificador de activityName.

calorías
activities.calories integer

Número de calorías quemadas durante el ejercicio.

caloríasLink
activities.caloriesLink string

Punto de conexión de API web para llamar a para obtener las calorías específicas quemadas para el ejercicio con nombre.

duration
activities.duration integer

El período de tiempo (milisegundos) después de editar el ejercicio. Si el ejercicio no se editó, la duración = originalDuration. Este valor contendrá pausas durante el ejercicio.

elevationGain
activities.elevationGain float

Elevación obtenida durante el ejercicio.

última modificación
activities.lastModified string

Marca de tiempo que el ejercicio se modificó por última vez.

logId
activities.logId integer

Identificador del registro de actividad del ejercicio.

Tipo de registro
activities.logType string

auto_detected | manual | mobile_run | rastreador | el nombre de la aplicación de terceros

calorías
activities.manualValuesSpecified.calories boolean

Valor booleano que indica si se proporcionaron calorías al registrar el ejercicio.

distance
activities.manualValuesSpecified.distance boolean

Valor booleano que indica si se proporcionó distancia al grabar el ejercicio.

steps
activities.manualValuesSpecified.steps boolean

Valor booleano que indica si se proporcionaron los pasos al grabar el ejercicio.

originalDuration
activities.originalDuration integer

La duración inicial en el tiempo (milisegundos) que se registró en el ejercicio. Este valor contendrá pausas durante el ejercicio.

originalStartTime
activities.originalStartTime string

Fecha y hora de inicio inicial que se registró el ejercicio.

startTime
activities.startTime string

Fecha y hora de inicio después de editar el ejercicio. Si el ejercicio no se editó, startTime = originalStartTime.

steps
activities.steps integer

Número de pasos realizados durante el ejercicio.

tcxLink
activities.tcxLink string

Dirección URL para descargar el archivo TCX.

afterDate
pagination.afterDate string

afterDate

limit
pagination.limit integer

limit

próximo
pagination.next string

próximo

offset
pagination.offset integer

offset

anterior
pagination.previous string

anterior

sort
pagination.sort string

sort

Obtener lista de registros de suspensión

Devuelve una lista de las entradas del registro de suspensión de un usuario antes o después de una fecha determinada.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Después de la fecha
afterDate string

Después de la fecha en la que se devuelve el registro de suspensión del usuario (aaaa-mm-dd)

Fecha anterior
beforeDate string

Antes de la fecha en la que se devuelve el registro de suspensión del usuario (aaaa-mm-dd)

Ordenar
sort string

ascendente o descendente

Limit
limit integer

Número de registros de suspensión que se van a devolver. (máximo 100)

Devoluciones

Nombre Ruta de acceso Tipo Description
afterDate
pagination.afterDate string

afterDate

limit
pagination.limit integer

limit

próximo
pagination.next string

próximo

offset
pagination.offset integer

offset

anterior
pagination.previous string

anterior

sort
pagination.sort string

sort

sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string
duration
sleep.duration integer

duration

eficacia
sleep.efficiency integer

eficacia

endTime
sleep.endTime string

endTime

infoCode
sleep.infoCode integer

infoCode

isMainSleep
sleep.isMainSleep boolean

isMainSleep

datos
sleep.levels.data array of object

datos

fechaHora
sleep.levels.data.dateTime string

fechaHora

nivel
sleep.levels.data.level string

nivel

segundos
sleep.levels.data.seconds integer

segundos

shortData
sleep.levels.shortData array of object

shortData

fechaHora
sleep.levels.shortData.dateTime string

fechaHora

nivel
sleep.levels.shortData.level string

nivel

segundos
sleep.levels.shortData.seconds integer

segundos

count
sleep.levels.summary.deep.count integer

count

minutes
sleep.levels.summary.deep.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

logId
sleep.logId integer

logId

Tipo de registro
sleep.logType string

Tipo de registro

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

type
sleep.type string

type

Obtener objetivos corporales

Recupera los objetivos de grasa corporal y peso de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Tipo de objetivo
goal-type True string

Tipo de objetivo

Devoluciones

Nombre Ruta de acceso Tipo Description
goalType
goal.goalType string
startDate
goal.startDate string

Fecha de inicio del objetivo.

startWeight
goal.startWeight float

Peso del usuario cuando se estableció el objetivo.

weight
goal.weight float

Objetivo de peso que se va a lograr.

weightThreshold
goal.weightThreshold float

Cantidad recomendada de peso para perder cada semana para lograr y mantener el objetivo.

Obtener objetivos de actividad

Recupera los objetivos actuales de actividad diaria o semanal de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de usuario
user-id True string

Identificador codificado del usuario

Período
period True string

daily| semanal

Devoluciones

Nombre Ruta de acceso Tipo Description
activeMinutes
goals.activeMinutes integer

Objetivo de minutos activos diarios. No se devuelve un valor para los objetivos semanales.

activeZoneMinutes
goals.activeZoneMinutes integer

Objetivo de minutos de zona activa diaria o semanal.

caloriesOut
goals.caloriesOut integer

Calorías diarias quemadas objetivo. No se devuelve un valor para los objetivos semanales.

distance
goals.distance float

Objetivo de distancia diaria o semanal.

pisos
goals.floors integer

Planta diaria o semanal sube el objetivo.

steps
goals.steps integer

Objetivo de los pasos diarios o semanales realizados.

Obtener perfil

Recupera los datos del perfil del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
aboutMe
user.aboutMe string

La información "Acerca de mí" especificada en la configuración de la cuenta del usuario.

edad
user.age string

Edad basada en su cumpleaños especificado en la configuración de la cuenta del usuario.

embajador
user.ambassador string

embajador

autoStrideEnabled
user.autoStrideEnabled string

autoStrideEnabled

avatar
user.avatar string

avatar

avatar150
user.avatar150 string

avatar150

avatar640
user.avatar640 string

avatar640

averageDailySteps
user.averageDailySteps string

Promedio de pasos diarios calculados para el usuario.

challengesBeta
user.challengesBeta string

challengesBeta

clockTimeDisplayFormat
user.clockTimeDisplayFormat string

clockTimeDisplayFormat

country
user.country string

country

corporativo
user.corporate string

corporativo

corporateAdmin
user.corporateAdmin string

corporateAdmin

dateOfBirth
user.dateOfBirth string

dateOfBirth

Nombre para mostrar
user.displayName string

Nombre para mostrar

displayNameSetting
user.displayNameSetting string

displayNameSetting

distanceUnit
user.distanceUnit string

distanceUnit

encodedId
user.encodedId string

encodedId

exerciseGoal
user.features.exerciseGoal string

exerciseGoal

firstName
user.firstName string

firstName

foodsLocale
user.foodsLocale string

foodsLocale

fullName
user.fullName string

fullName

gender
user.gender string

gender

glucosaUnit
user.glucoseUnit string

glucosaUnit

altura
user.height string

Valor de alto especificado en la configuración de la cuenta del usuario.

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

configuración regional
user.locale string

configuración regional

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

estado
user.state string

estado

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

Matriz en la que se enumeran las insignias de Fitbit que el usuario ha obtenido actualmente.

waterUnit
user.waterUnit string

waterUnit

waterUnitName
user.waterUnitName string

waterUnitName

weight
user.weight string

weight

weightUnit
user.weightUnit string

weightUnit

Obtener registro de grasa corporal

Recupera una lista de todas las entradas del registro de grasa corporal del usuario para una fecha determinada.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha con el formato aaaa-mm-dd.

Devoluciones

Nombre Ruta de acceso Tipo Description
gordo
fat array of object

gordo

date
fat.date string

Fecha en que se registró el registro de grasa corporal.

gordo
fat.fat integer

Porcentaje de grasa corporal.

logId
fat.logId integer

Identificador del registro de grasa corporal.

source
fat.source string

Ubicación donde se originaron los datos de grasa corporal.

time
fat.time string

Marca de tiempo cuando se registró el registro de grasa corporal.

Obtener registro de peso

Recupera una lista de todas las entradas del registro de peso del usuario para una fecha determinada.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha con el formato aaaa-mm-dd

Devoluciones

Nombre Ruta de acceso Tipo Description
weight
weight array of object

weight

IMC
weight.bmi float

IMC calculado con el formato X.XX

date
weight.date string

Fecha de entrada del registro con el formato aaaa-mm-dd.

gordo
weight.fat integer
logId
weight.logId integer

Los identificadores de registro de peso son únicos para el usuario, pero no son únicos globalmente.

source
weight.source string

source

time
weight.time string

Tiempo de la medición; horas y minutos con el formato HH:mm:ss, establecido en el último segundo del día si no se proporciona.

weight
weight.weight integer

Peso en el formato X.XX, en el sistema de unidades que corresponde al encabezado Accept-Language proporcionado o si no se proporciona en la métrica.

Obtener registro de suspensión por fecha

Devuelve una lista de las entradas del registro de suspensión de un usuario para una fecha determinada.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

aaaa-mm-dd

Devoluciones

Nombre Ruta de acceso Tipo Description
sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string

Fecha en que finalizó el registro de suspensión

duration
sleep.duration integer

Longitud de la suspensión en milisegundos.

eficacia
sleep.efficiency integer

Puntuación calculada de eficiencia del sueño. Esta no es la puntuación de suspensión disponible en la aplicación móvil.

endTime
sleep.endTime string

Hora en que finalizó el registro de suspensión.

infoCode
sleep.infoCode integer

Valor entero que representa la calidad de los datos recopilados en el registro de suspensión. 0 = Datos suficientes para generar un registro de suspensión. 1 = Datos de frecuencia cardíaca insuficientes. 2 = El período de suspensión era demasiado corto (menos de 3 horas). 3 = Problema del lado servidor.

isMainSleep
sleep.isMainSleep boolean

Boolean

datos
sleep.levels.data array of object

datos

fechaHora
sleep.levels.data.dateTime string

fechaHora

nivel
sleep.levels.data.level string

nivel

segundos
sleep.levels.data.seconds integer

segundos

shortData
sleep.levels.shortData array of object

shortData

fechaHora
sleep.levels.shortData.dateTime string

fechaHora

nivel
sleep.levels.shortData.level string

nivel

segundos
sleep.levels.shortData.seconds integer

segundos

count
sleep.levels.summary.deep.count integer

count

minutes
sleep.levels.summary.deep.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

logId
sleep.logId integer

Id. de registro de suspensión.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

Número total de minutos después de que el usuario se despertó.

minutesAsleep
sleep.minutesAsleep integer

Número total de minutos que el usuario estaba dormido.

minutesAwake
sleep.minutesAwake integer

Solo la suma total de minutos de "reactivación". No incluye antes de dormir o después de despertarse.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

Número total de minutos antes de que el usuario se quede dormido. Este valor suele ser 0 para los registros de suspensión creados automáticamente.

Tipo de registro
sleep.logType string

auto_detected | Manual

startTime
sleep.startTime string

Hora en que comienza el registro de suspensión.

timeInBed
sleep.timeInBed integer

Número total de minutos que el usuario estaba en cama.

type
sleep.type string

clásico | Etapas

profundo
summary.stages.deep integer

profundo

luz
summary.stages.light integer

luz

rem
summary.stages.rem integer

rem

despertar
summary.stages.wake integer

despertar

totalMinutesAsleep
summary.totalMinutesAsleep integer

Número total de minutos que el usuario estaba dormido en todos los registros de suspensión del registro de suspensión.

totalSleepRecords
summary.totalSleepRecords integer

Número de registros de suspensión dentro del registro de suspensión.

totalTimeInBed
summary.totalTimeInBed integer

Número total de minutos que el usuario estaba en cama en todos los registros del registro de suspensión.

Obtener registro de suspensión por intervalo de fechas

Devuelve una lista de las entradas del registro de suspensión de un usuario para un intervalo de fechas.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha de inicio
startDate True string

Fecha para que se devuelva el primer registro de suspensión (aaaa-mm-dd)

Fecha de finalización
endDate True string

Fecha para que se devuelva el último registro de suspensión (aaaa-mm-dd)

Devoluciones

Nombre Ruta de acceso Tipo Description
sleep
sleep array of object

sleep

dateOfSleep
sleep.dateOfSleep string

Fecha en que finalizó el registro de suspensión.

duration
sleep.duration integer

Longitud de la suspensión en milisegundos.

eficacia
sleep.efficiency integer

Puntuación calculada de eficiencia del sueño. Esta no es la puntuación de suspensión disponible en la aplicación móvil.

endTime
sleep.endTime string

Hora en que finalizó el registro de suspensión.

infoCode
sleep.infoCode integer

Valor entero que representa la calidad de los datos recopilados en el registro de suspensión. 0 = Datos suficientes para generar un registro de suspensión. 1 = Datos de frecuencia cardíaca insuficientes. 2 = El período de suspensión era demasiado corto (menos de 3 horas). 3 = Problema del lado servidor.

isMainSleep
sleep.isMainSleep boolean

Boolean

datos
sleep.levels.data array of object

datos

fechaHora
sleep.levels.data.dateTime string

fechaHora

nivel
sleep.levels.data.level string

nivel

segundos
sleep.levels.data.seconds integer

segundos

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

treintaDayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

treintaDayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

treintaDayAvgMinutes

shortData
sleep.levels.shortData array of object

shortData

fechaHora
sleep.levels.shortData.dateTime string

fechaHora

nivel
sleep.levels.shortData.level string

nivel

segundos
sleep.levels.shortData.seconds integer

segundos

logId
sleep.logId integer

Id. de registro de suspensión.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

Número total de minutos después de que el usuario se despertó.

minutesAsleep
sleep.minutesAsleep integer

Número total de minutos que el usuario estaba dormido.

minutesAwake
sleep.minutesAwake integer

Solo la suma total de minutos de "reactivación". No incluye antes de dormir o después de despertarse.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

Número total de minutos antes de que el usuario se quede dormido. Este valor suele ser 0 para los registros de suspensión creados automáticamente.

Tipo de registro
sleep.logType string

auto_detected | Manual

startTime
sleep.startTime string

Hora en que comienza el registro de suspensión

timeInBed
sleep.timeInBed integer

Número total de minutos que el usuario estaba en la cama

type
sleep.type string

clásico | Etapas

Obtener resumen de actividad diaria

Recupera un resumen y una lista de las entradas del registro de actividad y las actividades de un usuario durante un día determinado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha

Devoluciones

Nombre Ruta de acceso Tipo Description
activities
activities array of

activities

activeMinutes
goals.activeMinutes integer

activeMinutes

caloriesOut
goals.caloriesOut integer

caloriesOut

distance
goals.distance float

distance

pisos
goals.floors integer

pisos

steps
goals.steps integer

steps

activeScore
summary.activeScore integer

activeScore

activityCalories
summary.activityCalories integer

activityCalories

calorieEstimationMu
summary.calorieEstimationMu integer

calorieEstimationMu

caloríasBMR
summary.caloriesBMR integer

caloríasBMR

caloriesOut
summary.caloriesOut integer

caloriesOut

caloriesOutUnestimated
summary.caloriesOutUnestimated integer

caloriesOutUnestimated

customHeartRateZones
summary.customHeartRateZones array of object

customHeartRateZones

caloriesOut
summary.customHeartRateZones.caloriesOut integer

caloriesOut

max
summary.customHeartRateZones.max integer

max

min
summary.customHeartRateZones.min integer

min

minutes
summary.customHeartRateZones.minutes integer

minutes

nombre
summary.customHeartRateZones.name string

nombre

Distancias
summary.distances array of object

Distancias

actividad
summary.distances.activity string

< > nombre de la actividad | total | tracker | loggedActivities | veryActive | moderatelyActive | lightlyActive |activeyActive

distance
summary.distances.distance integer

Para el recurso especificado, la distancia que ha recorrido el día que se muestra en las unidades definidas por el encabezado Accept-Language.

elevación
summary.elevation integer

La elevación viaja por el día que se muestra en las unidades definidas por el encabezado Accept-Language.

fairlyActiveMinutes
summary.fairlyActiveMinutes integer

Total de minutos que el usuario estaba bastante/moderado activo.

pisos
summary.floors integer

Los pisos equivalentes escalados para el día mostrados en las unidades definidas por el encabezado Accept-Language.

heartRateZones
summary.heartRateZones array of object

heartRateZones

caloriesOut
summary.heartRateZones.caloriesOut integer

caloriesOut

max
summary.heartRateZones.max integer

max

min
summary.heartRateZones.min integer

min

minutes
summary.heartRateZones.minutes integer

minutes

nombre
summary.heartRateZones.name string

El ámbito de frecuencia cardíaca es necesario para ver este valor. Fuera del intervalo | Quemar grasa | Cardio | Pico

lightlyActiveMinutes
summary.lightlyActiveMinutes integer

Total de minutos que el usuario estaba activo ligeramente.

marginalCalories
summary.marginalCalories integer

Total de calorías estimadas marginales quemadas durante el día.

restingHeartRate
summary.restingHeartRate integer

El ámbito de frecuencia cardíaca es necesario para ver este valor.

arbitraryMinutes
summary.sedentaryMinutes integer

Total de minutos que el usuario era arbitrario.

steps
summary.steps integer

Total de pasos realizados durante el día.

useEstimation
summary.useEstimation boolean

Valor booleano que indica si se usan estimaciones en cálculos.

veryActiveMinutes
summary.veryActiveMinutes integer

Total de minutos que el usuario estaba muy activo.

Obtener resumen de frecuencia de respiración por fecha

Este punto de conexión devuelve el promedio de datos de frecuencia de respiración para una sola fecha. Los datos de frecuencia de respiración se aplican específicamente a la "suspensión principal" de un usuario, que es el período de tiempo más largo durante el cual estaban dormidos en una fecha determinada.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha con el formato aaaa-mm-dd o hoy.

Devoluciones

Nombre Ruta de acceso Tipo Description
Br
br array of object

Br

breathingRate
br.value.breathingRate float

Número medio de respiraciones tomadas por minuto.

fechaHora
br.dateTime string

Fecha del registro de suspensión especificada en el formato AAAA-MM-DD.

Obtener resumen de HRV por fecha

Este punto de conexión devuelve los datos de variabilidad de frecuencia cardíaca (HRV) para una sola fecha.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha con el formato aaaa-MM-dd o hoy.

Devoluciones

Nombre Ruta de acceso Tipo Description
hrv
hrv array of object

hrv

dailyRmssd
hrv.value.dailyRmssd float

El cuadrado medio raíz de las diferencias sucesivas (RMSSD) entre latidos del corazón. Mide la variabilidad a corto plazo en la frecuencia cardíaca diaria del usuario en milisegundos (ms).

deepRmssd
hrv.value.deepRmssd float

El cuadrado medio raíz de las diferencias sucesivas (RMSSD) entre latidos del corazón. Mide la variabilidad a corto plazo en la frecuencia cardíaca del usuario mientras está en sueño profundo, en milisegundos (ms).

fechaHora
hrv.dateTime string

Fecha del registro de suspensión especificada en el formato AAAA-MM-DD.

Obtener resumen máximo de VO2 por fecha

Devuelve los datos de La puntuación de fitness cardio (también conocido como VO2 Max) para una sola fecha. Los valores máximos vo2 se mostrarán como un intervalo si no hay datos de ejecución disponibles o un valor numérico único si el usuario usa un GPS para las ejecuciones. Consulte Información adicional para obtener más contexto.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha con el formato aaaa-mm-dd o hoy.

Devoluciones

Nombre Ruta de acceso Tipo Description
cardioScore
cardioScore array of object

cardioScore

fechaHora
cardioScore.dateTime string

Fecha especificada en el formato AAAA-MM-DD.

vo2Max
cardioScore.value.vo2Max string

Valor que se puede mostrar de VO2 Max en mL/kg/min

Obtener serie temporal de grasa corporal por fecha

Recupera una lista de todas las entradas del registro de grasa corporal del usuario durante un período determinado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha de finalización del período especificado en el formato aaaa-mm-dd o hoy.

Período
period True string

Intervalo para el que se devolverán los datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
gordo
fat array of object

gordo

date
fat.date string

Fecha en que se registró el registro de grasa corporal.

gordo
fat.fat float

Porcentaje de grasa corporal.

logId
fat.logId integer

Identificador del registro de grasa corporal.

source
fat.source string

Ubicación donde se originaron los datos de grasa corporal. Consulte valores de "origen" para obtener más información.

time
fat.time string

Marca de tiempo cuando se registró el registro de grasa corporal.

Obtener serie temporal del cuerpo por fecha

Recupera una lista del peso, la grasa corporal o el peso de todos los usuarios durante un período determinado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Resource
resource True string

Recurso body que se va a devolver.

Fecha
date True string

Fecha de finalización del período especificado en el formato aaaa-mm-dd o hoy.

Período
period True string

Intervalo para el que se devolverán los datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
peso corporal
body-weight array of object

peso corporal

fechaHora
body-weight.dateTime string

fechaHora

value
body-weight.value string

value

Obtener series temporales de actividad por fecha

Recupera los datos de actividad de un recurso determinado durante un período de tiempo especificando una fecha y un período de tiempo. La respuesta incluirá solo los valores de resumen diarios.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Resource
resource True string

Recurso de los datos que se van a devolver.

Fecha
date True string

Fecha de finalización del período especificado en el formato aaaa-mm-dd

Período
period True string

Intervalo para el que se devolverán los datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
activities-steps
activities-steps array of object

activities-steps

fechaHora
activities-steps.dateTime string

fechaHora

value
activities-steps.value string

value

Obtener series temporales de peso por fecha

Recupera una lista de todas las entradas del registro de peso del usuario durante un período determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de usuario
user-id True string

Identificador codificado del usuario

Fecha
date True string

Fecha de finalización del período especificado en el formato aaaa-mm-dd o hoy.

Período
period True string

Intervalo para el que se devolverán los datos.

Devoluciones

Nombre Ruta de acceso Tipo Description
weight
weight array of object

weight

IMC
weight.bmi float

EL IMC calculado con el formato X.XX.

date
weight.date string

Fecha de entrada del registro con el formato aaaa-mm-dd.

gordo
weight.fat integer

Porcentaje de grasa corporal.

logId
weight.logId integer

Identificadores de registro de peso. Es único para el usuario, pero no es único globalmente.

source
weight.source string

Origen del registro de peso.

time
weight.time string

Tiempo de la medición; horas y minutos con el formato HH:mm:ss, establecido en el último segundo del día si no se proporciona.

weight
weight.weight integer

Peso en el formato X.XX, en el sistema de unidades que corresponde al encabezado Accept-Language proporcionado o si no se proporciona en la métrica.

Obtener tabla de clasificación de amigos

Este punto de conexión devuelve la tabla de clasificación de confianza del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
datos
data array of object

datos

type
data.type string

type

id
data.id string

id

clasificación de pasos
data.attributes.step-rank integer

Clasificación entre los amigos del usuario.

step-summary
data.attributes.step-summary integer

Recuento semanal de pasos.

type
data.relationships.user.data.type string

type

id
data.relationships.user.data.id string

id

incluido
included array of object

incluido

type
included.type string

type

id
included.id string

id

avatar
included.attributes.avatar string

Vínculo a la imagen del avatar del usuario.

secundario
included.attributes.child boolean

secundario

amigo
included.attributes.friend boolean

amigo

nombre
included.attributes.name string

nombre

Obtener tipo de actividad

Recupera los detalles de una sola actividad de la base de datos de actividades de Fitbit en el formato solicitado. Si está disponible, se mostrarán los detalles del nivel de actividad.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Id. de actividad
activity-id True string

Id. de actividad

Devoluciones

Nombre Ruta de acceso Tipo Description
accessLevel
activity.accessLevel string

PUBLIC | PRIVADO

activityLevels
activity.activityLevels array of object

activityLevels

id
activity.activityLevels.id integer

Valor numérico que representa el nivel de actividad correspondiente.

maxSpeedMPH
activity.activityLevels.maxSpeedMPH float

Velocidad máxima en MPH. Valor: -1 significa que no es aplicable.

Mets
activity.activityLevels.mets integer

Puntuación de MET para el identificador de actividad.

minSpeedMPH
activity.activityLevels.minSpeedMPH integer

Velocidad mínima en MPH. Valor: -1 significa que no es aplicable.

nombre
activity.activityLevels.name string

Nombre del nivel de actividad.

hasSpeed
activity.hasSpeed boolean

true | falso

id
activity.id integer

Valor numérico que representa la actividad correspondiente.

nombre
activity.name string

Nombre de la actividad o ejercicio.

Obtener tipos de actividad recientes

Recupera una lista de los tipos de actividades recientes de un usuario registrados con algunos detalles del último registro de actividad de ese tipo.

Parámetros

Nombre Clave Requerido Tipo Description
ID de usuario
user-id True string

Identificador codificado del usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
activityId
activityId integer

Identificador numérico de la actividad o ejercicio.

calorías
calories integer

Número de calorías quemadas durante la actividad registrada.

descripción
description string

Información, si está disponible, sobre la actividad o el ejercicio.

distance
distance integer

Distancia viajada durante la actividad registrada.

duration
duration integer

Cantidad de tiempo (milisegundos) para completar la actividad registrada.

nombre
name string

Nombre de la actividad o ejercicio.

Obtener todos los tipos de actividad

Recupera una lista de todas las actividades públicas de Fitbit válidas y las actividades privadas creadas por el usuario de la base de datos de actividades de Fitbit en el formato solicitado. Si está disponible, se mostrarán los detalles del nivel de actividad.

Devoluciones

Nombre Ruta de acceso Tipo Description
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

Mets
categories.activities.activityLevels.mets integer

Mets

minSpeedMPH
categories.activities.activityLevels.minSpeedMPH integer

minSpeedMPH

nombre
categories.activities.activityLevels.name string

nombre

hasSpeed
categories.activities.hasSpeed boolean

hasSpeed

id
categories.activities.id integer

id

nombre
categories.activities.name string

nombre

Mets
categories.activities.mets float

Mets