다음을 통해 공유


Fitbit(독립 게시자)(미리 보기)

Fitbit Web API에 액세스하는 방법

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 애쉬윈 가네시 쿠마르
URL https://www.blisdigital.com/
전자 메일 a.kumar@blisdigital.com
커넥터 메타데이터
게시자 애쉬윈 가네시 쿠마르
웹 사이트 https://dev.fitbit.com//
개인 정보 보호 정책 https://www.fitbit.com/global/nl/legal/privacy-policy
카테고리 데이터

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

가중치 로그 가져오기

지정된 날짜에 대한 모든 사용자의 가중치 로그 항목 목록을 검색합니다.

날짜 범위별 절전 로그 가져오기

날짜 범위에 대한 사용자의 절전 로그 항목 목록을 반환합니다.

날짜별 HRV 요약 가져오기

이 엔드포인트는 단일 날짜에 대한 HRV(심박수 가변성) 데이터를 반환합니다.

날짜별 VO2 최대 요약 가져오기

단일 날짜에 대한 심장 피트니스 점수(VO2 Max라고도 함) 데이터를 반환합니다. VO2 최대값은 실행 데이터를 사용할 수 없는 경우 범위로, 사용자가 실행에 GPS를 사용하는 경우 단일 숫자 값으로 표시됩니다. 추가 컨텍스트는 추가 정보를 참조하세요.

날짜별 가중치 시계열 가져오기

지정된 기간 동안 모든 사용자의 가중치 로그 항목 목록을 검색합니다.

날짜별 본문 시계열 가져오기

지정된 기간 동안 모든 사용자의 bmi, 체지방 또는 체중 목록을 검색합니다.

날짜별 절전 로그 가져오기

지정된 날짜에 대한 사용자의 절전 로그 항목 목록을 반환합니다.

날짜별 체지방 시계열 가져오기

지정된 기간 동안 모든 사용자의 체지방 로그 항목 목록을 검색합니다.

날짜별 호흡 속도 요약 가져오기

이 엔드포인트는 단일 날짜에 대한 평균 호흡 속도 데이터를 반환합니다. 호흡 속도 데이터는 특정 날짜에 잠들어 있었던 가장 긴 단일 기간인 사용자의 "주 수면"에 특히 적용됩니다.

날짜별 활동 시계열 가져오기

날짜 및 기간을 지정하여 일정 기간 동안 지정된 리소스에 대한 활동 데이터를 검색합니다. 응답에는 일일 요약 값만 포함됩니다.

모든 활동 형식 가져오기

Fitbit 활동 데이터베이스에서 요청된 형식으로 유효한 모든 Fitbit 공용 활동 및 사용자가 만든 개인 활동 목록을 검색합니다. 사용 가능한 경우 활동 수준 세부 정보가 표시됩니다.

배지 가져오기

사용자의 배지 목록을 검색합니다.

수명 통계 가져오기

사용자의 활동 통계를 검색합니다.

신체 목표 가져오기

사용자의 체지방 및 체중 목표를 검색합니다.

알람 가져오기

특정 디바이스에 대해 사용하도록 설정된 알람을 검색합니다.

일일 활동 요약 가져오기

지정된 날짜에 대한 사용자의 활동 및 활동 로그 항목의 요약 및 목록을 검색합니다.

자주 활동 가져오기

사용자의 빈번한 활동 목록을 검색합니다.

장치 가져오기

사용자 계정에 페어링된 Fitbit 디바이스 목록을 검색합니다.

절전 로그 목록 가져오기

지정된 날짜 전후에 사용자의 절전 모드 로그 항목 목록을 반환합니다.

절전 모드 목표 가져오기

사용자의 인코딩된 ID를 지정합니다. 현재 로그인한 사용자에 대해 "-"(대시)를 사용합니다.

즐겨찾기 활동 가져오기

사용자의 즐겨찾기 활동 목록을 검색합니다.

체지방 로그 가져오기

지정된 날짜에 대한 모든 사용자의 체지방 로그 항목 목록을 검색합니다.

최근 활동 유형 가져오기

해당 형식의 마지막 활동 로그에 대한 일부 세부 정보와 함께 기록된 사용자의 최근 활동 유형 목록을 검색합니다.

친구 순위표 가져오기

이 엔드포인트는 사용자의 friend 순위표를 반환합니다.

프로필 가져오기

사용자의 프로필 데이터를 검색합니다.

활동 TCX 가져오기

TCX(학습 센터 XML)는 GPS, 심박수 및 랩 데이터를 포함하는 데이터 교환 형식입니다. 이 엔드포인트는 기록된 운동 중에 GPS 및 심박수 데이터를 사용하여 사용자의 위치 세부 정보를 검색합니다.

활동 로그 목록 가져오기

지정된 날짜 전후에 사용자의 활동 로그 항목 목록을 검색합니다.

활동 목표 가져오기

사용자의 현재 일별 또는 주간 활동 목표를 검색합니다.

활동 유형 가져오기

Fitbit 활동 데이터베이스에서 요청된 형식으로 단일 활동에 대한 세부 정보를 검색합니다. 사용 가능한 경우 활동 수준 세부 정보가 표시됩니다.

가중치 로그 가져오기

지정된 날짜에 대한 모든 사용자의 가중치 로그 항목 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd 형식의 날짜입니다.

반환

Name 경로 형식 Description
무게
weight array of object

무게

bmi
weight.bmi float

X.XX 형식의 계산된 BMI

date
weight.date string

yy-mm-dd형식의 로그 항목 날짜입니다.

지방
weight.fat integer
logId
weight.logId integer

가중치 로그 ID는 사용자에게 고유하지만 전역적으로 고유하지는 않습니다.

source
weight.source string

source

time
weight.time string

측정 시간; HH:mm:ss 형식의 시간 및 분이며, 제공되지 않으면 하루의 마지막 초로 설정됩니다.

무게
weight.weight integer

제공된 Accept-Language 헤더에 해당하는 단위 시스템의 X.XX 형식 또는 메트릭에 제공되지 않은 경우의 가중치입니다.

날짜 범위별 절전 로그 가져오기

날짜 범위에 대한 사용자의 절전 로그 항목 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

시작 날짜
startDate True string

첫 번째 절전 로그가 반환될 날짜(yyyy-mm-dd)

종료 날짜
endDate True string

반환할 마지막 절전 로그의 날짜(yyyy-mm-dd)

반환

Name 경로 형식 Description
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

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

30DayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

30DayAvgMinutes

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

절전 로그 ID입니다.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

사용자가 잠에서 깨어난 후의 총 시간(분)입니다.

minutesAsleep
sleep.minutesAsleep integer

사용자가 잠들어 있는 총 시간(분)입니다.

minutesAwake
sleep.minutesAwake integer

"절식" 분만의 총 합계입니다. 그것은 잠들기 전에 또는 깨어난 후 포함하지 않습니다.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

사용자가 잠들기 전의 총 시간(분)입니다. 이 값은 일반적으로 자동 절전 모드에서 만든 절전 로그의 경우 0입니다.

로그 유형
sleep.logType string

auto_detected | 수동

startTime
sleep.startTime string

절전 로그가 시작되는 시간

timeInBed
sleep.timeInBed integer

사용자가 침대에 누워 있는 총 시간(분)

type
sleep.type string

클래식 | 단계

날짜별 HRV 요약 가져오기

이 엔드포인트는 단일 날짜에 대한 HRV(심박수 가변성) 데이터를 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-MM-dd 또는 오늘 형식의 날짜입니다.

반환

Name 경로 형식 Description
hrv
hrv array of object

hrv

dailyRmssd
hrv.value.dailyRmssd float

심장 박동 간의 연속적인 차이(RMSSD)의 루트 평균 제곱입니다. 사용자의 일일 심박수의 단기 가변성을 밀리초(밀리초)로 측정합니다.

deepRmssd
hrv.value.deepRmssd float

심장 박동 간의 연속적인 차이(RMSSD)의 루트 평균 제곱입니다. 그것은 깊은 수면에있는 동안 사용자의 심박수의 단기 가변성을 측정, 밀리초 (ms).

날짜시간
hrv.dateTime string

YYYY-MM-DD 형식으로 지정된 절전 로그 날짜입니다.

날짜별 VO2 최대 요약 가져오기

단일 날짜에 대한 심장 피트니스 점수(VO2 Max라고도 함) 데이터를 반환합니다. VO2 최대값은 실행 데이터를 사용할 수 없는 경우 범위로, 사용자가 실행에 GPS를 사용하는 경우 단일 숫자 값으로 표시됩니다. 추가 컨텍스트는 추가 정보를 참조하세요.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd 또는 오늘 형식의 날짜입니다.

반환

Name 경로 형식 Description
cardioScore
cardioScore array of object

cardioScore

날짜시간
cardioScore.dateTime string

YYYY-MM-DD 형식으로 지정된 날짜입니다.

vo2Max
cardioScore.value.vo2Max string

표시 가능한 VO2 Max(mL/kg/min)입니다.

날짜별 가중치 시계열 가져오기

지정된 기간 동안 모든 사용자의 가중치 로그 항목 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd 또는 오늘 형식으로 지정된 기간의 종료 날짜입니다.

마침표
period True string

데이터가 반환될 범위입니다.

반환

Name 경로 형식 Description
무게
weight array of object

무게

bmi
weight.bmi float

X.XX 형식의 계산된 BMI입니다.

date
weight.date string

yy-mm-dd형식의 로그 항목 날짜입니다.

지방
weight.fat integer

체지방 백분율입니다.

logId
weight.logId integer

가중치 로그 ID입니다. 사용자에게 고유하지만 전역적으로 고유하지는 않습니다.

source
weight.source string

가중치 로그의 원본입니다.

time
weight.time string

측정 시간; HH:mm:ss 형식의 시간 및 분이며, 제공되지 않으면 하루의 마지막 초로 설정됩니다.

무게
weight.weight integer

제공된 Accept-Language 헤더에 해당하는 단위 시스템의 X.XX 형식 또는 메트릭에 제공되지 않은 경우의 가중치입니다.

날짜별 본문 시계열 가져오기

지정된 기간 동안 모든 사용자의 bmi, 체지방 또는 체중 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

Resource
resource True string

반환할 본문 리소스입니다.

날짜
date True string

yyyy-mm-dd 또는 오늘 형식으로 지정된 기간의 종료 날짜입니다.

마침표
period True string

데이터가 반환될 범위입니다.

반환

Name 경로 형식 Description
체중
body-weight array of object

체중

날짜시간
body-weight.dateTime string

날짜시간

value
body-weight.value string

value

날짜별 절전 로그 가져오기

지정된 날짜에 대한 사용자의 절전 로그 항목 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd

반환

Name 경로 형식 Description
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

minutes
sleep.levels.summary.deep.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

30DayAvgMinutes

logId
sleep.logId integer

절전 로그 ID입니다.

minutesAfterWakeup
sleep.minutesAfterWakeup integer

사용자가 잠에서 깨어난 후의 총 시간(분)입니다.

minutesAsleep
sleep.minutesAsleep integer

사용자가 잠들어 있는 총 시간(분)입니다.

minutesAwake
sleep.minutesAwake integer

"절식" 분만의 총 합계입니다. 그것은 잠들기 전에 또는 깨어난 후 포함하지 않습니다.

minutesToFallAsleep
sleep.minutesToFallAsleep integer

사용자가 잠들기 전의 총 시간(분)입니다. 이 값은 일반적으로 자동 절전 모드에서 만든 절전 로그의 경우 0입니다.

로그 유형
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

사용자가 수면 로그의 모든 레코드에서 침대에 누워 있는 총 시간(분)입니다.

날짜별 체지방 시계열 가져오기

지정된 기간 동안 모든 사용자의 체지방 로그 항목 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd 또는 오늘 형식으로 지정된 기간의 종료 날짜입니다.

마침표
period True string

데이터가 반환될 범위입니다.

반환

Name 경로 형식 Description
지방
fat array of object

지방

date
fat.date string

체지방 로그가 기록된 날짜입니다.

지방
fat.fat float

체지방 백분율입니다.

logId
fat.logId integer

체지방 로그 ID입니다.

source
fat.source string

체지방 데이터가 시작된 위치입니다. 자세한 내용은 "원본" 값을 참조하세요.

time
fat.time string

체지방 로그가 기록된 타임스탬프입니다.

날짜별 호흡 속도 요약 가져오기

이 엔드포인트는 단일 날짜에 대한 평균 호흡 속도 데이터를 반환합니다. 호흡 속도 데이터는 특정 날짜에 잠들어 있었던 가장 긴 단일 기간인 사용자의 "주 수면"에 특히 적용됩니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd 또는 오늘 형식의 날짜입니다.

반환

Name 경로 형식 Description
br
br array of object

br

breathingRate
br.value.breathingRate float

분당 평균 호흡 횟수입니다.

날짜시간
br.dateTime string

YYYY-MM-DD 형식으로 지정된 절전 로그 날짜입니다.

날짜별 활동 시계열 가져오기

날짜 및 기간을 지정하여 일정 기간 동안 지정된 리소스에 대한 활동 데이터를 검색합니다. 응답에는 일일 요약 값만 포함됩니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

Resource
resource True string

반환할 데이터의 리소스입니다.

날짜
date True string

yyyy-mm-dd 형식으로 지정된 기간의 종료 날짜입니다.

마침표
period True string

데이터가 반환될 범위입니다.

반환

Name 경로 형식 Description
활동 단계
activities-steps array of object

활동 단계

날짜시간
activities-steps.dateTime string

날짜시간

value
activities-steps.value string

value

모든 활동 형식 가져오기

Fitbit 활동 데이터베이스에서 요청된 형식으로 유효한 모든 Fitbit 공용 활동 및 사용자가 만든 개인 활동 목록을 검색합니다. 사용 가능한 경우 활동 수준 세부 정보가 표시됩니다.

반환

Name 경로 형식 Description
categories
categories array of object

categories

activities
categories.activities array of object

activities

액세스 수준
categories.activities.accessLevel string

액세스 수준

activityLevels
categories.activities.activityLevels array of object

activityLevels

아이디
categories.activities.activityLevels.id integer

아이디

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

아이디
categories.activities.id integer

아이디

이름
categories.activities.name string

이름

메츠
categories.activities.mets float

메츠

배지 가져오기

사용자의 배지 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
배지
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

배지가 달성된 날짜입니다.

description
badges.description string

description

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

단위 측정의 배지 목표입니다.

수명 통계 가져오기

사용자의 활동 통계를 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 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

바닥
lifetime.total.floors integer

바닥

steps
lifetime.total.steps integer

steps

activeScore
lifetime.tracker.activeScore integer

activeScore

caloriesOut
lifetime.tracker.caloriesOut integer

caloriesOut

distance
lifetime.tracker.distance float

distance

바닥
lifetime.tracker.floors integer

바닥

steps
lifetime.tracker.steps integer

steps

신체 목표 가져오기

사용자의 체지방 및 체중 목표를 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

목표 유형
goal-type True string

목표 유형

반환

Name 경로 형식 Description
goalType
goal.goalType string
startDate
goal.startDate string

목표 시작 날짜입니다.

startWeight
goal.startWeight float

목표가 설정되었을 때 사용자의 가중치입니다.

무게
goal.weight float

달성할 가중치 목표입니다.

weightThreshold
goal.weightThreshold float

목표를 달성하고 유지하기 위해 매주 잃을 무게의 권장 금액.

알람 가져오기

특정 디바이스에 대해 사용하도록 설정된 알람을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

추적기 ID
tracker-id True string

데이터가 반환되는 추적기의 ID입니다.

반환

Name 경로 형식 Description
trackerAlarms
trackerAlarms array of object

trackerAlarms

alarmId
trackerAlarms.alarmId integer

알람 ID를 나타내는 숫자 값입니다.

삭제됨
trackerAlarms.deleted boolean

알람이 삭제되었는지를 나타냅니다.

enabled
trackerAlarms.enabled boolean

알람을 사용할 수 있는지를 나타냅니다.

되풀이
trackerAlarms.recurring boolean

알람이 되풀이되는지를 나타냅니다.

snoozeCount
trackerAlarms.snoozeCount integer

알람이 다시 알림되는 횟수를 나타냅니다.

snoozeLength
trackerAlarms.snoozeLength integer

다시 알림 기간 사이의 시간(분)을 나타냅니다.

syncedToDevice
trackerAlarms.syncedToDevice boolean

true | false

time
trackerAlarms.time string

지정된 경보의 시간 및 UTC 오프셋입니다.

느낌
trackerAlarms.vibe string

구성된 진동 유형을 반환합니다.

weekDays
trackerAlarms.weekDays array of string

weekDays

일일 활동 요약 가져오기

지정된 날짜에 대한 사용자의 활동 및 활동 로그 항목의 요약 및 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

날짜

반환

Name 경로 형식 Description
activities
activities array of

activities

activeMinutes
goals.activeMinutes integer

activeMinutes

caloriesOut
goals.caloriesOut integer

caloriesOut

distance
goals.distance float

distance

바닥
goals.floors integer

바닥

steps
goals.steps integer

steps

activeScore
summary.activeScore integer

activeScore

activityCalories
summary.activityCalories integer

activityCalories

calorieEstimationMu
summary.calorieEstimationMu integer

calorieEstimationMu

caloriesBMR
summary.caloriesBMR integer

caloriesBMR

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

이름
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

caloriesOut
summary.heartRateZones.caloriesOut integer

caloriesOut

max
summary.heartRateZones.max integer

max

min
summary.heartRateZones.min integer

min

minutes
summary.heartRateZones.minutes integer

minutes

이름
summary.heartRateZones.name string

이 값을 보려면 심박수 범위가 필요합니다. 범위를 벗어났습니다. | Fat Burn | Cardio | 봉우리

lightlyActiveMinutes
summary.lightlyActiveMinutes integer

사용자가 가볍게 활동한 총 시간(분)입니다.

marginalCalories
summary.marginalCalories integer

하루 동안 연소 된 총 한계 추정 칼로리.

restingHeartRate
summary.restingHeartRate integer

이 값을 보려면 심박수 범위가 필요합니다.

sedentaryMinutes
summary.sedentaryMinutes integer

사용자가 앉아있는 총 시간(분)입니다.

steps
summary.steps integer

해당 날짜에 대해 수행된 총 단계입니다.

useEstimation
summary.useEstimation boolean

계산에 예측이 사용되는지 여부를 나타내는 부울 값입니다.

veryActiveMinutes
summary.veryActiveMinutes integer

사용자가 매우 활성화된 총 시간(분)입니다.

자주 활동 가져오기

사용자의 빈번한 활동 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
array of object
activityId
activityId integer

기록된 활동의 식별자 번호입니다.

칼로리
calories integer

활동과 관련된 소모된 칼로리의 수입니다.

description
description string

기록된 활동에 대한 추가 정보입니다.

distance
distance integer

기록된 활동과 관련된 이동 거리입니다.

duration
duration integer

연습을 편집한 후의 시간(밀리초)입니다. 이 값은 연습 중에 일시 중지를 포함합니다.

이름
name string

기록된 활동의 이름입니다.

장치 가져오기

사용자 계정에 페어링된 Fitbit 디바이스 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
array of object
battery
battery string

디바이스의 배터리 수준을 반환합니다.

batteryLevel
batteryLevel integer

디바이스의 배터리 수준 백분율을 반환합니다.

deviceVersion
deviceVersion string

디바이스의 제품 이름입니다.

features
features array of

features

아이디
id string

디바이스 ID입니다.

lastSyncTime
lastSyncTime string

디바이스가 Fitbit 모바일 애플리케이션과 마지막으로 동기화된 시간을 나타내는 타임스탬프입니다.

mac
mac string

Mac ID 번호

type
type string

TRACKER | 저울

절전 로그 목록 가져오기

지정된 날짜 전후에 사용자의 절전 모드 로그 항목 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

이후 날짜
afterDate string

사용자의 절전 로그가 반환된 날짜 이후(yyyy-mm-dd)

이전 날짜
beforeDate string

사용자의 절전 로그가 반환되는 날짜 이전(yyyy-mm-dd)

Sort
sort string

오름차순 또는 내림차순

한계
limit integer

반환할 절전 로그의 수입니다. (최대 100개)

반환

Name 경로 형식 Description
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

minutes
sleep.levels.summary.deep.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.deep.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.light.count integer

count

minutes
sleep.levels.summary.light.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.light.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.rem.count integer

count

minutes
sleep.levels.summary.rem.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.rem.thirtyDayAvgMinutes integer

30DayAvgMinutes

count
sleep.levels.summary.wake.count integer

count

minutes
sleep.levels.summary.wake.minutes integer

minutes

30DayAvgMinutes
sleep.levels.summary.wake.thirtyDayAvgMinutes integer

30DayAvgMinutes

logId
sleep.logId integer

logId

로그 유형
sleep.logType string

로그 유형

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

절전 모드 목표 가져오기

사용자의 인코딩된 ID를 지정합니다. 현재 로그인한 사용자에 대해 "-"(대시)를 사용합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
flowId
consistency.flowId integer

0 = 절전 목표를 설정했지만 기록된 절전 로그가 충분하지 않습니다. 1 = 사용자가 수면 목표를 놓쳤거나 목표가 설정되지 않았지만 기록된 충분한 수면 로그가 있습니다. 2 = 수면 목표가 설정되지 않았으며 기록된 절전 로그가 충분하지 않습니다. 3 = 사용자가 수면 목표를 달성했습니다.

minDuration
goal.minDuration integer

수면 목표 기간의 길이(분)입니다.

updatedOn
goal.updatedOn string

목표가 생성/업데이트된 타임스탬프입니다.

즐겨찾기 활동 가져오기

사용자의 즐겨찾기 활동 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
array of object
activityId
activityId integer

기록된 활동의 식별자 번호입니다.

description
description string

기록된 활동에 대한 추가 정보입니다.

메츠
mets integer

수행된 활동의 메타볼릭 해당(MET)입니다.

이름
name string

기록된 활동의 이름입니다.

체지방 로그 가져오기

지정된 날짜에 대한 모든 사용자의 체지방 로그 항목 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

날짜
date True string

yyyy-mm-dd형식의 날짜입니다.

반환

Name 경로 형식 Description
지방
fat array of object

지방

date
fat.date string

체지방 로그가 기록된 날짜입니다.

지방
fat.fat integer

체지방 백분율입니다.

logId
fat.logId integer

체지방 로그 ID입니다.

source
fat.source string

체지방 데이터가 시작된 위치입니다.

time
fat.time string

체지방 로그가 기록된 타임스탬프입니다.

최근 활동 유형 가져오기

해당 형식의 마지막 활동 로그에 대한 일부 세부 정보와 함께 기록된 사용자의 최근 활동 유형 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
array of object
activityId
activityId integer

활동 또는 연습의 숫자 ID입니다.

칼로리
calories integer

기록된 활동 중에 소모된 칼로리의 수입니다.

description
description string

사용 가능한 경우 활동 또는 연습에 대한 정보입니다.

distance
distance integer

기록된 활동 중에 이동한 거리입니다.

duration
duration integer

기록된 작업을 완료하는 데 걸리는 시간(밀리초)입니다.

이름
name string

활동 또는 연습의 이름입니다.

친구 순위표 가져오기

이 엔드포인트는 사용자의 friend 순위표를 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
데이터
data array of object

데이터

type
data.type string

type

아이디
data.id string

아이디

단계별 순위
data.attributes.step-rank integer

사용자의 친구 중 순위입니다.

단계 요약
data.attributes.step-summary integer

주별 단계 수입니다.

type
data.relationships.user.data.type string

type

아이디
data.relationships.user.data.id string

아이디

포함
included array of object

포함

type
included.type string

type

아이디
included.id string

아이디

아바타
included.attributes.avatar string

사용자의 아바타 그림에 연결합니다.

아이
included.attributes.child boolean

아이

친구
included.attributes.friend boolean

친구

이름
included.attributes.name string

이름

프로필 가져오기

사용자의 프로필 데이터를 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

반환

Name 경로 형식 Description
aboutMe
user.aboutMe string

사용자의 계정 설정에 지정된 "내 정보" 정보입니다.

연령
user.age string

사용자의 계정 설정에서 지정한 생일을 기준으로 하는 연령입니다.

대사
user.ambassador string

대사

autoStrideEnabled
user.autoStrideEnabled string

autoStrideEnabled

아바타
user.avatar string

아바타

avatar150
user.avatar150 string

avatar150

avatar640
user.avatar640 string

avatar640

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

exerciseGoal
user.features.exerciseGoal string

exerciseGoal

이름 (첫 번째 이름)
user.firstName string

이름 (첫 번째 이름)

foodsLocale
user.foodsLocale string

foodsLocale

fullName
user.fullName string

fullName

gender
user.gender string

gender

glucoseUnit
user.glucoseUnit string

glucoseUnit

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

시간대
user.timezone string

시간대

topBadges
user.topBadges string

사용자가 현재 획득한 Fitbit 배지를 나열하는 배열입니다.

waterUnit
user.waterUnit string

waterUnit

waterUnitName
user.waterUnitName string

waterUnitName

무게
user.weight string

무게

무게 단위
user.weightUnit string

무게 단위

활동 TCX 가져오기

TCX(학습 센터 XML)는 GPS, 심박수 및 랩 데이터를 포함하는 데이터 교환 형식입니다. 이 엔드포인트는 기록된 운동 중에 GPS 및 심박수 데이터를 사용하여 사용자의 위치 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용의 인코딩된 ID

로그 ID
log-id True string

활동의 로그 ID입니다.

부분 TCX
includePartialTCX boolean

GPS 데이터를 사용할 수 없는 경우 TCX 지점을 포함합니다.

활동 로그 목록 가져오기

지정된 날짜 전후에 사용자의 활동 로그 항목 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

이후 날짜
afterDate string

이후 날짜(yyyy-mm-dd)

이전 날짜
beforeDate string

이전 날짜(yyyy-mm-dd)

Sort
sort string

날짜별 항목의 정렬 순서입니다.

한계
limit integer

반환된 항목 수입니다.

반환

Name 경로 형식 Description
activities
activities array of object

activities

activeDuration
activities.activeDuration integer

각 activityLevel 내의 시간(밀리초)입니다.

activityLevel
activities.activityLevel array of object

activityLevel

minutes
activities.activityLevel.minutes integer

minutes

이름
activities.activityLevel.name string

이름

activityName
activities.activityName string

기록된 연습의 이름입니다.

activityTypeId
activities.activityTypeId integer

activityName의 식별자 번호입니다.

칼로리
activities.calories integer

운동 중 소모된 칼로리의 수입니다.

caloriesLink
activities.caloriesLink string

명명된 연습에 대해 소모된 특정 칼로리를 얻기 위해 호출하는 Web API 엔드포인트입니다.

duration
activities.duration integer

연습을 편집한 후의 시간(밀리초)입니다. 연습을 편집하지 않은 경우 duration = originalDuration입니다. 이 값은 연습 중에 일시 중지를 포함합니다.

elevationGain
activities.elevationGain float

권한 상승은 연습 중에 얻은 것입니다.

최종 수정
activities.lastModified string

연습이 마지막으로 수정된 타임스탬프입니다.

logId
activities.logId integer

연습의 활동 로그 식별자입니다.

로그 유형
activities.logType string

auto_detected | manual | 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

TCX 파일을 다운로드하는 URL입니다.

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

활동 목표 가져오기

사용자의 현재 일별 또는 주간 활동 목표를 검색합니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

마침표
period True string

매일| 매주

반환

Name 경로 형식 Description
activeMinutes
goals.activeMinutes integer

일일 활성 시간(분) 목표입니다. 주간 목표에 대한 값은 반환되지 않습니다.

activeZoneMinutes
goals.activeZoneMinutes integer

매일 또는 매주 활성 영역 분 목표.

caloriesOut
goals.caloriesOut integer

일일 칼로리는 목표를 태웠습니다. 주간 목표에 대한 값은 반환되지 않습니다.

distance
goals.distance float

매일 또는 매주 거리 목표.

바닥
goals.floors integer

매일 또는 매주 층이 목표를 올라갔습니다.

steps
goals.steps integer

목표를 달성한 매일 또는 매주 단계.

활동 유형 가져오기

Fitbit 활동 데이터베이스에서 요청된 형식으로 단일 활동에 대한 세부 정보를 검색합니다. 사용 가능한 경우 활동 수준 세부 정보가 표시됩니다.

매개 변수

Name 필수 형식 Description
사용자 ID
user-id True string

사용자의 인코딩된 ID

활동 ID
activity-id True string

활동 ID

반환

Name 경로 형식 Description
액세스 수준
activity.accessLevel string

PUBLIC | 민간의

activityLevels
activity.activityLevels array of object

activityLevels

아이디
activity.activityLevels.id integer

해당 작업 수준을 나타내는 숫자 값입니다.

maxSpeedMPH
activity.activityLevels.maxSpeedMPH float

MPH의 최대 속도입니다. 값: -1 적용할 수 없음을 의미합니다.

메츠
activity.activityLevels.mets integer

활동 ID에 대한 MET 점수입니다.

minSpeedMPH
activity.activityLevels.minSpeedMPH integer

MPH의 최소 속도입니다. 값: -1 적용할 수 없음을 의미합니다.

이름
activity.activityLevels.name string

활동 수준의 이름입니다.

hasSpeed
activity.hasSpeed boolean

true | false

아이디
activity.id integer

해당 활동을 나타내는 숫자 값입니다.

이름
activity.name string

활동 또는 연습의 이름입니다.