数据模型-REST-基础能力服务 API 参考-运动健康服务

ActivityRecord

展开

参数	参数类型	是否必选	说明	约束条件
appInfo	AppInfo	是	创建该运动记录的AppInfo。	-
id	String	是	客户端生成的标识符。特定用户拥有的所有运动记录中都是唯一的。	如果未指定标识符，将从开始时间和名称中创建一个。
modifyTime	Long	是	运动记录的最后修改时间。单位：毫秒	-
name	String	是	用户设定的运动记录名称。例如：“周日骑行”	-
startTime	Long	是	运动记录开始时间(inclusive)。单位：毫秒	-
endTime	Long	是	运动记录结束时间。单位：毫秒如果未指定标识该运动记录仍在进行中。	结束时间必须晚于开始时间。
timeZone	String	是	时区信息。	格式：+0800。
activeTime	Long	否	运动记录活跃时间。单位：毫秒	开始/结束时间标识了运动记录的完整持续时间；但运动记录活跃时间可以更短。
activitySummary	ActivitySummary	是	运动记录的概要汇总信息。	请参见数据模型。
activityType	Integer	是	运动记录对应的活动的类型。支持的运动类型请参见运动类型常量定义。	-
deviceInfo	DeviceInfo	否	集成各种传感器的硬件设备描述。例如：手表、手环等可穿戴设备。	-
cursor	String	否	查询分页标识。当查询结果大于一页时才包含。	-
desc	String	否	运动记录描述。	-
subDataRelation	List<SamplePointRelation>	否	子数据关联关系。	-
details	List<SampleSet>	否	运动记录明细。	-
metadata	String	否	扩展元，JSON格式字符串。	-
sourceType	Integer	否	数据来源类型 0：unknown（默认） 1：真实运动 2：用户手动输入 3：课程记录 4：可连接器械 5：自动识别	-
abnormal	Integer	否	异常运动记录标记位 0：不是 1：是	重要数据缺失、运动作弊等场景下，运动记录会被标记为异常运动记录。
duplicate	Integer	否	重复运动记录标记位 0：不是 1：是	同一时间段存在两条运动记录的场景下，其中一条会被标记为重复运动记录。

ActivitySummary

展开

参数	参数类型	是否必选	说明	约束条件
dataSummary	List<SamplePoint>	否	统计数据类型采样点列表。	只能是统计类型。建议开发者写入该字段。
paceSummary	PaceSummary	否	配速信息。	-
activityFeature	SamplePoint	否	运动记录特征数据点。	-
sectionSummary	List<SampleSection>	否	运动记录分段统计数据采样点列表。	-
performanceSummary	PerformanceSummary	否	运动记录训练表现数据	-

PaceSummary

展开

参数	参数类型	是否必选	说明	约束条件
avgPace	Double	是	平均配速。	单位是秒/公里。说明运动类型划船机的单位是秒/500米。
bestPace	Double	是	最佳配速。	单位是秒/公里。说明运动类型划船机的单位是秒/500米。
paceMap	Map<String,Double>	否	每公里配速表。	每公里的配速，单位是秒/公里。例如 "1.0":407.945 "2.0":473.98846 "2.170":473.98846 说明最后不满一公里的部分，按比例换算为整公里的配速存入。
partTimeMap	Map<String,Double>	否	分段累计时间表。	公制分段数据表（key：公里，value：秒）其中公里保留到小数点后4位。 Value是一个累积到当前公里的时间如： 1.0:3.0 2.0:6.0 3.0:9.0 21.0975:7020.0 42.195:18000.0 其中，21.0975，42.195分别为半马和全马的距离（仅半马全马小数点后不为0）。

PerformanceSummary

展开

参数	参数类型	是否必选	说明	约束条件
aerobicTrainingStress	Double	否	有氧训练压力	有氧训练压力值大于等于1.0小于等于5.0。
anaerobicTrainingStress	Double	否	无氧训练压力	无氧训练压力值大于等于1.0小于等于5.0。
recoveryTime	Integer	否	恢复时间	恢复时间大于0，单位：min（分钟）。
vo2Max	Integer	否	最大摄氧量	最大摄氧量大于0，单位：ml/kg/min。
loadPeak	Integer	否	训练负荷	训练负荷大于0。
paceZoneStatistics	Map<String, Integer>	否	配速区间统计，key：区间ID，value：统计值，单位秒	-
heartRateZoneStatistics	Map<String, Integer>	否	心率区间统计，key：区间ID，value：统计值，单位秒	-
runningAbility	Double	否	单次跑力	-
aerobicLoadPeak	Integer	否	有氧负荷	-
anaerobicLoadPeak	Integer	否	无氧负荷	-

AppInfo

展开

参数	参数类型	是否必选	说明
appName	String	appName和appPackageName至少存在一个。	应用的名称。长度范围：1~1000 注意针对GPRS设备接入场景appName请拼接前缀com.huawei.health.cloud.device,完整参数请参见如下示例：com.huawei.health.cloud.device.appName
appPackageName	String	appName和appPackageName至少存在一个。	应用程序的包名称。长度范围：1~300 如果appPackageName/clientId同时存在，appPackageName/clientId必须匹配。
appVersion	String	否	应用的版本信息。长度范围：1~1000
clientId	String	否	应用ID。由数字组成，长度范围：2~128
desc	String	否	用于链接该应用程序的URL。长度范围：1~1000

DataCollector

展开

参数	参数类型	是否必选	说明
appInfo	AppInfo	是	数据采集器的应用程序信息。
collectorDataType	DataType	是	数据类型定义。
collectorType	String	是	数据采集器类型常量。可支持的取值如下： derived：派生数据类型 raw：原始数据类型
collectorId	String	否	-
collectorName	String	否	内部标识。使用该名称来标识用户下同一类型数据产生的数据采集器。
deviceInfo	DeviceInfo	否	集成各种传感器的硬件设备描述。例如：手表、手环等可穿戴设备。
name	String	否	用户页面展示的数据采集器名称。
lastUpdateTime	Long	否	向此数据采集器中上传或删除采样数据的最后更新时间。

DataType

展开

参数	参数类型	是否必选	说明	约束条件
field	List<DataTypeField>	是	数据类型的一个维度。	请参见DataTypeField数据模型。说明公共数据类型无需关注该字段，将由Health Service Kit写入。自定义数据类型需自行补齐字段值。
name	String	是	每个数据类型唯一的、命名空间的名称。长度范围：1~300	HUAWEI提供了一组以com.huawei.命名空间开头的共享、可见的健康数据类型，也支持自定义数据类型，但是自定义的name不能以com.huawei.开头。

参数

参数类型

是否必选

说明

约束条件

field

List<DataTypeField>

是

数据类型的一个维度。

请参见DataTypeField数据模型。

说明

公共数据类型无需关注该字段，将由Health Service Kit写入。
自定义数据类型需自行补齐字段值。

name

String

是

每个数据类型唯一的、命名空间的名称。

长度范围：1~300

HUAWEI提供了一组以com.huawei.命名空间开头的共享、可见的健康数据类型，也支持自定义数据类型，但是自定义的name不能以com.huawei.开头。

DataType.Field

展开

参数	参数类型	是否必选	说明	约束条件
format	String	是	数据类型中每个维度的支持格式。	可支持的格式如下： float integer map string long
name	String	是	定义的该数据维度的名称。	长度范围：1~1000 同一个DataType内，field不能重复。如果使用HUAWEI提供的数据类型中的各公共数据类型，field要与定义的字段一致。
desc	String	否	描述信息。	长度范围：1~1000。
optional	Boolean	否	对应数据赋值时是否必填： true：可选 false：必选未配置时，默认必选。	-

DelAuthRecord

展开

参数	参数类型	是否必选	说明
clientId	String	是	应用ID。
deauthorizedTime	Long	是	取消授权的UTC时间戳。单位毫秒
packageName	String	是	应用名称。

DeviceInfo

展开

参数	参数类型	是否必选	说明	约束条件
devType	String	是	设备类型。	可支持的类型如下： Phone：手机 Smart watch：智能手表 Smart band：智能手环 Smart earphone：耳机 Scales：体脂秤 Blood glucose monitor：血糖仪 Blood pressure monitor：血压计 Ecg equipment：心电设备 Heart rate monitor：心率设备 Thermometers：体温计 Oximeter：血氧仪 Treadmill：跑步机 Elliptical machine：椭圆机 Exercise bike：动感单车 Rowing machine：划船机 Walking machine：步行机 Rope skipping：跳绳 Third watch：第三手表 Ventilator：呼吸机 Unknown：未知设备
manufacturer	String	是	产品制造商。	长度范围：1~300。
modelNum	String	是	终端型号名称。	长度范围：1~300。
uniqueId	String	是	华为设备唯一标识UDID或其他厂商设备唯一标识。	长度范围：1~300。
version	String	否	设备硬件/软件版本。	长度范围：1~1000。
prodId	String	否	生态设备的华为全场景产品ID。	长度范围：1~6。注意针对GPRS设备接入场景prodId字段为必填项。
devId	String	否	生态设备的华为全场景设备ID。	长度范围：1~40。
deviceCode	Long	否	绑定后生成的设备编码。	-
bindStatus	Integer	否	设备绑定状态。	设备绑定状态： 1：设备未绑定 2：设备非本人绑定（冲突） 3：设备本人绑定

DeviceInfoV2

展开

参数	参数类型	是否必选	说明
devType	String	是	设备类型。
uniqueId	String	是	华为设备唯一标识SN。
version	String	是	版本号。
modelNum	String	是	终端型号名称。
manufacturer	String	是	产品制造商。
prodId	String	是	生态设备的华为全场景产品ID。
deviceCode	Long	是	绑定后生成的设备编码。
mac	String	是	设备MAC地址。
deviceName	String	是	华为设备名称。

DeviceBindInfo

展开

参数	参数类型	是否必选	说明
appInfo	AppInfo	是	数据采集器的应用程序信息。
deviceInfo	DeviceInfoV2	否	集成各种传感器的硬件设备描述。例如：手表、手环等可穿戴设备。

Group

展开

参数	参数类型	是否必选	说明	约束条件
sampleSet	List<SampleSet>	是	该请求中每个PolymerizeWith将有一个采样集。	-
endTime	Long	否	聚合数据组的结束时间(inclusive)。单位:毫秒	-
startTime	Long	否	聚合数据组的开始时间(inclusive)。单位:毫秒	-

GroupByTime

展开

参数	参数类型	是否必选	说明	约束条件
duration	Long	参数互斥，至多配置其中之一。	指定按照精确的duration时间帧来分组聚合数据到结果组。单位：毫秒	不含数据的时间范围将包含在响应中，但采样集为空。配置时必须大于0。
groupPeriod	GroupByTimeGroupPeriod	分组周期。	配置时必须大于0。

参数

参数类型

是否必选

说明

约束条件

duration

Long

参数互斥，至多配置其中之一。

指定按照精确的duration时间帧来分组聚合数据到结果组。单位：毫秒

不含数据的时间范围将包含在响应中，但采样集为空。

配置时必须大于0。

groupPeriod

GroupByTimeGroupPeriod

分组周期。

配置时必须大于0。

GroupByTimeGroupPeriod

展开

参数	参数类型	是否必选	说明	约束条件
timeZone	String	是	时区。	格式：+0800。
unit	String	是	时间类型。	可支持的取值如下： day month。month以30天为单位聚合 week
value	Integer	是	聚合周期值，需要和unit组合使用。	-

参数

参数类型

是否必选

说明

约束条件

timeZone

String

是

时区。

格式：+0800。

unit

String

是

时间类型。

可支持的取值如下：

day
month。month以30天为单位聚合
week

value

Integer

是

聚合周期值，需要和unit组合使用。

-

PolymerizeWith

展开

参数	参数类型	是否必选	说明	约束条件
dataCollectorId	String	参数互斥，必须且只能配置其中之一。	要聚合的数据采集器ID。	-
dataTypeName	String	参数互斥，必须且只能配置其中之一。	要聚合的数据类型。属于此类型的数据都会被聚合到一起。	长度范围：[1, 300]。

SampleConfig

展开

参数	参数类型	是否必选	说明	约束条件
type	String	是	配置类别	当前只开放9002配置类别。
id	String	是	配置ID	当前只开放900200006(步数)、900200007(活动热量)、900200008(锻炼时长)、900200009(活动小时数)四种id查询。
scopeApp	String	否	配置所属应用	-
scopeDeviceType	String	否	配置所属设备	-
configData	String	否	配置内容	-
modifyTime	Long	否	配置最后修改时间	-

SamplePoint

展开

参数	参数类型	是否必选	说明	约束条件
dataTypeName	String	是	数据类型名称。	-
endTime	Long	是	结束时间。单位：纳秒	-
startTime	Long	是	开始时间。单位：纳秒	-
value	List<SamplePointValue>	是	数据值。数据的顺序和类型需要与DataCollector中dataType定义保持一致。	-
modifyTime	Long	否	最后修改该采样点的时间。单位：毫秒	仅在查询数据变更历史时可见。
originalDataCollectorId	String	否	原始数据采集器ID。仅在该SamplePoint被包含在派生dataCollector的SampleSet中时有效。	-
metadata	String	否	扩展元，JSON格式字符串	-
说明一个SamplePoint可以被多个SampleSet包含。 metadata在不同数据类型场景下的使用说明： dataTypeName=com.huawei.continuous.steps.delta（步数）扩展字段：motion_type（计步运动状态），取值如下： RUN（跑步） WALK（走路） STAIRS（爬楼） UNKNOWN（未知）例："metadata": "{\"motion_type\":\"WALK\"}" dataTypeName=com.huawei.instantaneous.blood_glucose（血糖）扩展字段：mIsConfirmed（用户确认状态），取值如下： true（已确认） false（未确认）例："metadata": "{\"mIsConfirmed\":true}"

SamplePoint.Value

展开

参数	参数类型	是否必选	说明	约束条件
fieldName	String	是	字段名称	-
floatValue	Double	否	浮点数值。	同时只有一个字段生效。
integerValue	Integer	否	整数值。
longValue	Long	否	长整型。
mapValue	List<SamplePointMap>	否	Map值。
stringValue	String	否	字符串值。应尽可能减小字符串长度，具有大字符串值和高数据频率的数据流可能会被降低采样。

SamplePoint.Value.Map

展开

参数	参数类型	是否必选	说明	约束条件
key	String	是	key。	-
value	SamplePointMapVal	是	SamplePointMapVal类型的value值。请参见	-

SamplePoint.Value.Map.Value

展开

参数	参数类型	是否必选	说明	约束条件
floatValue	Double	否	Map类型的采样点对应的浮点数值。	同时只有一个字段生效。
integerValue	Integer	否	Map类型的采样点对应的整数值。
longValue	Long	否	Map类型的采样点对应的长整型。
stringValue	String	否	Map类型的采样点对应的字符串值。应尽可能减小字符串长度，具有大字符串值和高数据频率的数据流可能会被降低采样。

SampleSection

展开

参数	参数类型	是否必选	说明	约束条件
sectionNum	Integer	是	分段索引。	-
sectionTime	Long	是	分段运动时长。单位：秒	-
startTime	Long	是	分段开始时间。单位：毫秒	分段开始时间大于等于运动记录开始时间。
endTime	Long	是	分段结束时间。单位：毫秒	分段结束时间必须晚于分段开始时间，且小于等于运动记录结束时间。
sectionDataList	List<SamplePoint>	是	运动记录分段统计数据采样点列表。	-

SampleSet

展开

参数	参数类型	是否必选	说明	约束条件
dataCollectorId	String	是	数据采集器ID。	-
endTime	Long	是	所有采样点的最大结束时间。单位：纳秒	-
samplePoints	List<SamplePoint>	是	SamplePoint列表。	完整数据：对于较小的SampleSet。部分数据：SampleSet查询，且采样集较大时；patching增量更新SampleSet时。
startTime	Long	是	所有采样点的最小开始时间。单位：纳秒	-
timeZone	String	是	时区信息。	格式：+0800。
cursor	String	否	SampleSet GET查询分页标识,且仅当查询结果大于一页时才包含。	-
说明 SampleSet是一组SamplePoint的容器，它本身没有任何信息。一个SamplePoint可以被多个SampleSet包含。

ScopeLangItem

展开

参数	参数类型	是否必选	说明	约束条件
url2Desc	Map<String, String>	是	ScopeUrl与Scope描述的map表达形式。	-
authTime	String	是	授权时间。	-
appName	Long	是	应用的名称。	-
appIconPath	String	是	应用的图标地址。	-

Subscription

展开

参数	参数类型	是否必选	说明	约束条件
appId	String	是	开发者应用ID。	-
eventType	String	是	关注/订阅的事件，由事件类别和子类别拼接而成。	-
type	String	是	事件类别	-
subType	String	是	事件子类别	-
subscriptionMode	int	是	订阅方式	0：HTTP订阅方式 1：PUSH订阅方式（暂不支持） 2：端侧订阅方式（PendingIntent）
subscriberId	String	是	订阅者ID。	-
subscriptionId	String	是	订阅记录ID。	-
openId	String	是	用户-appId，组合得到的唯一标识openId。	-
goalInfo	GoalInfo	否	场景订阅目标信息。	仅在eventType为SCENARIO_GOAL_EVENT$ACHIEVE时返回

EventType

展开

参数	参数类型	是否必选	说明	约束条件
type	String	是	订阅事件类别。	-
subType	String	是	订阅事件子类别。	-
eventType	String	是	订阅事件类型ID。	由type与subType按$连接，详见订阅事件
goalInfo	GoalInfo	否	场景订阅目标信息。	仅当eventType取值SCENARIO_GOAL_EVENT$ACHIEVE生效

Event

展开

参数	参数类型	是否必选	说明	约束条件
eventId	String	否	赛事Id（云侧生成）。	-
name	String	是	赛事名称，取值长度范围（0，64]。	-
holdingTime	Long	是	赛事举办的时间戳。	必须大于当前时间戳。
timeZone	String	是	时区信息，格式：+0800。	-
city	String	是	举办城市，取值长度范围：(0，128]。	-
type	int	是	主赛事类型。 0：跑步赛事。	-
subType	int	是	子赛事类型。 0：马拉松赛事。	-
totalDistance	Float	是	全程距离，单位：KM。	-
userChosenGroupType	int	是	用户报名参赛时，选择的参赛组别。 0：用户自定义赛事 1：全程马拉松赛事 2：半程马拉松赛事	-
userChosenDistance	Float	否	参赛距离，默认为全程距离，单位：KM。	-
modifyTime	Long	否	赛事更新时间（云侧生成）。	-
createTime	Long	否	赛事创建时间（云侧生成）。	-
appInfo	AppInfo	是	三方APP应用的相关信息。

GoalInfo

展开

参数	参数类型	是否必选	说明	约束条件
createTime	Long	否	目标创建时系统时间戳	单位：毫秒
startDay	Integer	是	目标开始计算日期	日期需大于当天日期
recurrence	Recurrence	是	目标周期	-
goals	List<Goal>	是	目标组合列表	-

Recurrence

展开

参数	参数类型	是否必选	说明	约束条件
count	int	是	周期次数	-
unit	int	是	周期单位	1：日 2：周 3：月
expectedAchievedCount	Integer	否	整个周期内期望达标次数	-

参数

参数类型

是否必选

说明

约束条件

count

int

是

周期次数

-

unit

int

是

周期单位

1：日

2：周

3：月

expectedAchievedCount

Integer

否

整个周期内期望达标次数

-

Goal

展开

参数	参数类型	是否必选	说明	约束条件
goalType	int	是	目标类别	取值如下： 1：测量值目标类型 2：持续时间目标类型 3：频率目标类型
metricGoal	MetricGoal	否	测量型目标	根据goalType值二选一，可按场景组合
durationGoal	DurationGoal	否	持续时间目标	根据goalType值二选一，可按场景组合
frequencyGoal	FrequencyGoal	否	频率目标	-

MetricGoal

展开

参数	参数类型	是否必选	说明	约束条件
value	double	是	目标值	-
fieldName	String	是	字段名称	-
dataType	String	是	测量目标统计数据类型	-
healthRecordType	String	否	目标健康记录类型	非空时，表示某个健康记录类型的{dataType}统计值目标
activityTypes	List<Integer>	否	目标运动类型列表	非空时，表示某个运动类型的{dataType}统计值目标

DurationGoal

展开

参数	参数类型	是否必选	说明	约束条件
duration	long	是	目标持续时长	单位：分钟
dataType	String	是	持续时间目标统计数据类型	-
healthRecordType	String	否	目标健康记录类型	非空时，表示某个健康记录类型的{dataType}统计值目标
activityTypes	List<Integer>	否	目标运动类型列表	非空时，表示某个运动类型的{dataType}统计值目标

FrequencyGoal

展开

参数	参数类型	是否必选	说明	约束条件
frequency	int	是	目标频率值	-
dataType	String	是	持续时间目标统计数据类型	-
healthRecordType	String	否	目标健康记录类型	非空时，表示某个健康记录类型的{dataType}统计值目标
activityTypes	List<Integer>	否	目标运动类型列表	非空时，表示某个运动类型的{dataType}统计值目标

AchieveRecord

展开

参数	参数类型	是否必选	说明	约束条件
openId	String	是	用户唯一标识openId	-
appId	String	是	第三方应用appId	-
subscriptionId	String	是	订阅记录Id	-
periodIndex	int	是	单周期索引	-
periodStartDay	int	是	单周期开始日期	日期格式：YYYYMMDD
periodEndDay	int	是	单周期结束日期	日期格式：YYYYMMDD
goalAchieve	List<GoalAchieve>	是	目标达成记录列表	-

GoalAchieve

展开

参数	参数类型	是否必选	说明	约束条件
goalType	int	是	目标类别	取值如下： 1：测量值目标类型 2：持续时间目标类型 3：频率目标类型
metricGoal	MetricGoal	否	测量型目标	根据goalType值二选一，可按场景组合
durationGoal	DurationGoal	否	持续时间目标	根据goalType值二选一，可按场景组合
achievedResult	String	是	实际记录值	-
achievedFlag	Boolean	是	是否已达标	-

MetaData

展开

参数	参数类型	是否必选	说明	约束条件
metaKey	String	是	元数据Key。当前支持的metaKey： startTime：删除或更新的数据变化的开始时间 endTime：删除或更新的数据变化的结束时间 activityType：删除或更新的ActivityRecord运动类型 datatype：原子采样数据类型 timeZone：时区 recordDay：运动记录日期 goalInfo：创建的原始目标信息 goalStatus：表示每单周期内，用户创建的每个目标达成状态列表 actualAchievedCount：实际目标达成次数累计	适用于用户运动记录事件和采样数据集事件，请参见订阅数据。
metaValue	String	是	元数据值。	-

参数

参数类型

是否必选

说明

约束条件

metaKey

String

是

元数据Key。

当前支持的metaKey：

startTime：删除或更新的数据变化的开始时间
endTime：删除或更新的数据变化的结束时间
activityType：删除或更新的ActivityRecord运动类型
datatype：原子采样数据类型
timeZone：时区
recordDay：运动记录日期
goalInfo：创建的原始目标信息
goalStatus：表示每单周期内，用户创建的每个目标达成状态列表
actualAchievedCount：实际目标达成次数累计

适用于用户运动记录事件和采样数据集事件，请参见订阅数据。

metaValue

String

是

元数据值。

-

HealthRecord

展开

参数	参数类型	是否必选	说明	约束条件
id	String	否	唯一标识。	-
dataTypeName	String	是	数据类型名称。	-
endTime	Long	是	结束时间。单位：纳秒	-
startTime	Long	是	开始时间。单位：纳秒	-
value	List<SamplePointValue>	是	数据值。数据的顺序和类型需要与DataCollector中dataType定义保持一致。	-
modifyTime	Long	否	最后修改该采样点的时间。单位：毫秒	仅在查询数据变更历史时可见。
originalDataCollectorId	String	否	原始数据采集器ID。仅在该SamplePoint被包含在派生dataCollector的SampleSet中时有效。	-
metadata	String	否	扩展元，JSON格式字符串。	-
subDataRelation	List<SamplePointRelation>	否	子数据关联关系。	-
subData	Map<String,SampleSet>	否	子数据	-
说明 subDataRelation的数据类型与healthRecord的数据存在关联关系。具体参考上传健康记录接口。

HealthRecords

展开

参数	参数类型	是否必选	说明	约束条件
healthRecords	List<HealthRecord>	是	唯一标识。	-
timeZone	String	是	时区信息，格式：+0800	-
cursor	String	否	查询分页标识。	-

SamplePointRelation

展开

参数	参数类型	是否必选	说明	约束条件
dataTypeName	String	是	数据类型名称。	-
endTime	Long	是	结束时间。单位：纳秒	-
startTime	Long	是	开始时间。单位：纳秒	-
dataCollectorId	String	是	原始数据采集器ID。	-

DeviceBindResp

展开

参数	参数类型	是否必选	说明	约束条件
deviceCode	Long	是	设备绑定码。	-
dataCollectors	List<DataCollector>	是	数据采集器列表	-

MessageResp

展开

参数	参数类型	是否必选	说明	约束条件
openId	String	是	用户唯一标识	-
dataType	String	是	数据类型	当前只支持all
pushTimestamp	Long	否	消息同步毫秒时间戳	仅当调用创建同步消息接口时返回
latestSyncTime	Long	否	最近一次消息同步毫秒时间戳	仅当调用查询最新一次数据同步时间接口时返回
hasIOSDevice	Boolean	否	该用户是否拥有iOS设备	仅当调用创建同步消息接口时返回

Workout

展开

参数	参数类型	是否必选	说明	约束条件
workoutId	String	否	课程Id	由云侧生成，[0，255]
name	String	是	活动名称	创建和更新时需要保证全局唯一
description	String	否	描述	[0，255]
createTime	Long	否	创建时间（云侧生成）	-
modifyTime	Long	否	更新时间（云侧生成）	-
actionCombine	List<ActionCombine>	是	训练步骤	-

ActionCombine

展开

参数	参数类型	是否必选	说明	约束条件
repeatTimes	int	是	训练步骤需要重复的次数	[1，100000]
actionList	List<RunAction>	是	跑步训练动作详情	[0，100]

RunAction

展开

参数	参数类型	是否必选	说明	约束条件
name	String	是	动作名称	取值如下： 1："Warm up"（热身） 2："Run"（跑步） 3："Walk"（走路） 4："Have a rest"（休息） 5："Relax"（放松）
describe	String	否	描述	[0，255]
target	Target	否	训练目标	-
strength	Strength	否	强度目标	-

Target

展开

参数	参数类型	是否必选	说明	约束条件
name	String	是	目标类型	取值如下： 1："distance"（距离） 2："time"（时间） 3："calorie"（卡路里）
value	double	是	描述	取值范围请参见name

参数

参数类型

是否必选

说明

约束条件

name

String

是

目标类型

取值如下：

1："distance"（距离）

2："time"（时间）

3："calorie"（卡路里）

value

double

是

描述

取值范围请参见name

name

展开

名称	单位	最小值	最大值
distance	metre	50	100950
time	second	1	86399
calorie	kcal	50	5000

Strength

展开

参数	参数类型	是否必选	说明	约束条件
name	String	是	目标类型	取值如下： 1："heart rate"（心率） 2："pace"（配速） 3："steps rate"（步频）
valueH	double	是	最大值	取值范围请参见name。
valueL	double	是	最小值	取值范围请参见name。

参数

参数类型

是否必选

说明

约束条件

name

String

是

目标类型

取值如下：

1："heart rate"（心率）

2："pace"（配速）

3："steps rate"（步频）

valueH

double

是

最大值

取值范围请参见name。

valueL

double

是

最小值

取值范围请参见name。

name

展开

名称	单位	最小值	最大值
heart rate	bpm	38	213
pace	ms/km	60000	959000
steps rate	steps/min	100	300

HealthTrend

展开

参数	参数类型	是否必选	说明	约束条件
dataType	String	必选	趋势统计数据类型	取值范围： com.huawei.continuous.steps.delta：步数 com.huawei.continuous.calories.burnt：热量 com.huawei.instantaneous.resting_heart_rate：静息心率 com.huawei.instantaneous.spo2：血氧饱和度 com.huawei.instantaneous.stress：压力 com.huawei.continuous.sleep.fragment：睡眠 com.huawei.continuous.exercise_intensity.v2：中高强度活动 com.huawei.active_hours：活动小时数
item	String	必选	趋势统计项	取值范围： Step：步数 Calorie：热量 RestingHeartRate：静息心率 SpO2：血氧饱和度 Stress：压力 AllSleepTime：睡眠时长 ExerciseIntensity：中高强度活动时长 ActiveHour：活动小时数
trendPeriod	int	必选	趋势统计周期	取值如下： 1：最近30天（一个月） 2：最近26周（半年）
startDate	int	必选	趋势统计起始日期	-
endDate	int	必选	趋势统计终止日期	-
statistical	boolean	必选	周期内是否可统计趋势	取值如下： true：满足趋势统计条件 false：不满足趋势统计条件（数据过少等原因）
daysNeed	int	可选	多少天后可统计趋势	-
trendConclusion	int	可选	趋势变化	取值如下： 1：上升 2：下降 3：不变
trendResult	int	可选	趋势变化影响	取值如下： 1：正向 2：负向 3：未知
trendSplitPosition	long	可选	趋势变化点	-
format	int	可选	数据格式	值类型，取值如下： 1：整型 2：浮点型
frontValue	String	可选	趋势变化前统计值	-
backValue	String	可选	趋势变化后统计值	-
diffValue	String	可选	切分前后差值	-
trendDescText	String	可选	趋势解读	-
statValues	List<PeriodStatistic>	可选	每段周期的健康数据平均值	-

PeriodStatistic

展开

参数	参数类型	是否必选	说明
startDate	int	必选	周期开始日期
avgValue	String	可选	周期平均值
minValue	String	可选	周期最小值
maxValue	String	可选	周期最大值
valueQuality	Float	可选	数值可信度

AthleticPerformance

展开

参数	参数类型	是否必选	说明
runningAbility	Double	必选	跑力指数，取值范围：20~90。
condition	Double	必选	状况指数，等级范围为： >6：长期未运动 (3, 6]：精力充沛 (0.5, 3]：状况良好 (-2, 0.5]：可以正常训练 (-6, -2]：轻微疲劳 (-10, -6]：非常疲劳 (-13, -10]：严重疲劳 <=-13：必须休息了
fitness	Double	必选	体能指数，取值范围：0~80。
fatigue	Double	必选	疲劳指数，取值范围：0~160。

PredictedTimes

展开

参数	参数类型	是否必选	说明
km1	Integer	必选	完赛预估时间，秒/1.6 公里，取值范围：214~780。
km3	Integer	必选	完赛预估时间，秒/3公里，取值范围：426~1524。
km5	Integer	必选	完赛预估时间，秒/5公里，取值范围：740~2750。
km10	Integer	必选	完赛预估时间，秒/10公里，取值范围：1541~5696。
halfMarathon	Integer	必选	完赛预估时间，秒/半马，取值范围：3388~12641。
marathon	Integer	必选	完赛预估时间，秒/全马，取值范围：7107~26334。

SportReports

展开

参数	参数类型	描述
activityType	String	运动类型
personalBest	List<BestSportReports>	个人成就最佳成绩
accumulate	List<AccumulatedSportReports>	个人成就的累计成绩

AccumulatedSportReports

展开

参数	参数类型	描述
name	String	成就名称
value	float	个人时间范围内最佳值
startDate	Long	开始日期
endDate	Long	结束日期

BestSportReports

展开

参数	参数类型	描述
name	String	成就名称
value	float	个人时间范围内最佳值
startTime	Long	开始日期
endTime	Long	结束日期
recordDay	Long	最佳成就所属日期