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 |
활동 또는 연습의 이름입니다. |