智慧健康养老 - 室内运动健康监测数据与运动数据接口技术要求

Q/LB.□XXXXX-XXXX范围本文件界定了智慧健康养老领域室内运动健康监测数据与运动数据接口的术语和定义，规定了系统结构与接口分类、数据接口的安全性要求、数据接口的消息格式要求。本文件适用于智慧健康养老领域室内运动场馆的运营管理系统与智能健康监测设备和智能运动器械之间的数据通讯接口设计。规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。JGJ/T484-2019养老服务智能化系统技术标准T/CSGF004—2018智慧化健身场所技术规范术语和定义下列术语和定义适用于本文件。智慧健康养老smartandhealthcarefortheaged利用物联网、云计算、大数据、智能硬件等新一代信息技术产品，实现个人、家庭、社区、机构与健康养老资源的有效对接和优化配置。老年人elderlypeople年满60周岁及以上的人。运动健康促进sportshealthpromotion通过适当的、科学合理的运动手段和方式增进人们控制和改善其健康的过程，预防疾病与促进健康。数据接口datainterface数据接口是软件开发商之间约定的数据标准与数据规范,数据接口的存在可以使不同软件之间的数据实现互通互联，解决软件之间的兼容性问题。缩略语下列缩略语适用于本文件CPU：中央处理器（CentralProcessingUnit）DAS：直连式存储（DirectAttachedStorage）NAS：网络附属存储（NetworkAttachedStorage）SAN：存储区域网络（StorageAreaNetwork）UUID：通用唯一识别码（UniversallyUniqueIdentifier）系统结构及数据接口分类系统结构室内运动场馆管理系统的系统结构见图1，智能健康监测设备和智能运动器械都通过WIFI、以太网的方式接入到互联网，与场馆运行系统通讯，实现身份鉴别、用户信息下发、运动建议下发、健康监测数据上传、运动数据上传等功能。智能健康监测设备智能健康监测设备场馆运营系统WIFI/以太网身份鉴别健康监测数据上传WIFI/以太网智能运动器械身份鉴别用户信息下发运动建议下发运动数据上传互联网系统结构图数据接口分类系统中涉及的数据接口分类见表1。系统接口分类表接口分类接口名称接口说明信息同步传入用户信息可传入字段：统一用户标识姓名身份证号手机号会员卡号识别用户身份验证用户身份支持的验证方式：人脸识别会员卡二维码手机号身份证获取登录二维码获取用于验证用户身份的二维码获取登录短信验证码发送用于验证用户身份的短信验证码上传人脸图片上传用于验证用户身份的人脸照片获取用户信息获取用户基本信息可获取的信息：性别年龄当前身高当前体重最高心率运动风险等级获取用户运动处方可获取的内容：最高运动强度最低运动强度最高心率区间最低心率区间最高锻炼时长最低锻炼时长运动风险提示上传数据上传用户体测数据可上传的数据：身高体重血压血氧脉搏握力肺活量坐姿体前屈选择反应时闭眼单脚站立人体成分体适能上传用户运动数据支持运动类别：有氧力量等速肌力柔韧拉伸微循环促进数据接口的安全性要求数据接口的通讯加密要求在数据的传输过程中，要求数据传输通道采用HTTPS的方式拉加密，并且采用TLS1.2及以上的加密协议，不允许使用SSL加密协议及TLS1.2以下版本的加密协议。数据接口的数字签名要求传输的数据要求有签名，并且采用HMAC-SHA256作为签名算法，秘钥长度最少64位，且每个请求要求有时间戳（Timestamp）来保证签名不能被重用。数据接口的数据传输要求敏感的数据（如用户的身份证号）必须通过POST的方式放在请求体（RequestBody）中加密传输，不允许放在请求头（RequestHead）和请求路径中明文传输。数据接口的消息格式要求通用要求统一用户标识为了保证在各个系统中对每个用户都有统一的标识，避免在各个系统中传输用户数据的时候产生混淆。本规范限定每个用户必须要有一个UUID来作为统一的用户标识，且此UUID的生成方法必须遵循由开放软件基金会(OSF)制定的RFC4122标准，以保证对在同一时空中的所有机器都是唯一的。状态码及错误信息为了保证错误得到正确的处理，要求每个接口的返回值都包含一个状态码表示请求处理的结果，通用的状态码定义见表2。通用返回状态码表错误代码分类错误代码说明指令执行失败1-999保留给各接口自定义业务流程中出现的失败，如用户名错误、密码错误签名验证失败1001没有上送设备id1002设备未注册（找不到设备key）1003没有上送签名1004签名比对失败用户登录问题2001用户id不存在2002用户token不存在或已过期（超过token有效期，或者被强制登出）参数错误3001缺少必要的参数（在错误消息中会提供更详细的信息）3002参数值超出允许范围（在错误消息中会提供更详细的信息）系统内部错误9001内部系统超时9999未知系统错误设备类型各接口中涉及到设备类型的字段，设备类型名称和ID的对应关系见表3.设备类型信息表设备大类名称设备类型名称设备类型ID功能性有氧跑步机100011卧式健身车100012四肢联动（前摆臂）100013四肢联动（侧摆臂）100014四肢联动健身车100015全身力量训练机100016认知运动训练机100017微循环促进扶手律动机100041律动平台100042律动沙发100043律动魔镜100044等速肌力等速胸推/划船训练机100021等速前踢/勾脚训练机100022等速腿部内收/外展训练机100023等速手臂开合训练机100024等速上推/下拉训练机100025等速腿部推蹬训练机100026等速腹背训练机100027等速扭腰训练机100028柔韧拉伸上肢功能训练器100031动态平衡训练器100032下肢平衡训练器100033核心控制训练器100034腰背功能训练器100035髋功能训练器100036单关节力量坐姿上推肩训练器100051坐姿推胸训练器100052坐姿蝴蝶扩胸展背训练器100053夹胸、提肩训练器100054坐姿下拉背训练器100055坐姿划船训练器100056坐姿平拉训练器100057高拉、低拉双功能训练器100058坐姿二头肌弯举训练器100059坐姿三头肌前压训练器1000511站姿肱二头、三头肌训练器1000512坐姿腹肌训练器1000513坐姿后仰腰背训练器1000514坐姿踢腿训练器1000515坐姿大腿后压训练器1000516俯卧后勾腿训练器1000517坐姿蹬腿训练器1000518臀部训练器1000519臀部训练器1000520坐姿内、外侧大腿肌臀肌训练器1000521站姿小腿训练器1000522助力式单双杠训练器1000523颈部旋转训练器1000524颈部屈伸与侧屈训练器1000525腰部侧曲训练器1000526腰部旋转训练器1000527信息同步相关接口传入用户信息要求能够支持传入表4所述的数据：传入用户信息请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份user_uuidString64统一用户标识nameString32用户姓名id_card_noString32用户身份证号mobile_numberString16用户手机号member_card_noString64用户会员卡号要求能够返回表5所述的数据：传入用户信息返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因识别用户身份相关接口识别用户身份要求能够支持传入表6所述的数据：识别用户身份请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份store_idString64门店IDauth_typeInteger32鉴权方法：1：NFC会员卡2：人脸识别3：身份证号4：二维码5：手机号+验证码auth_credentialString64鉴权要素：1.NFC会员卡送数字格式的卡号2.如果是人脸识别需要先上传照片后再上送照片文件名3.如果是身份证号需要满足身份证号的格式4送二维码中的字符串内容5送手机号和短信验证码，以’|’隔开，如123456”要求能够返回表7所述的数据：识别用户身份返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因user_uuidString64统一用户标识user_tokenString64用于用户鉴权的临时tokenuser_token_thrutimeLong64临时token的过期时间，是一个时间戳上传人脸照片要求能够支持传入表8所述的数据：上传人脸照片请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份image_file_typeString321：仅短期存储的文件，如登录用的人脸照片，每天会定期被清除2：需要长期存储的文件image_fileFile8M图片文件要求能够返回表9所述的数据：上传人脸照片返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因image_file_nameString64上传的图片在服务端存储的文件名获取用户登录二维码要求能够支持传入表10所述的数据：获取用户登录二维码请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份device_type_idString64设备类型id要求能够返回表11所述的数据：获取用户登录二维码返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误其它返回码见错误代码表resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因barcode_contentString4096获取用户信息相关接口获取用户信息要求能够支持传入表12所述的数据：获取用户信息请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份user_uuidString64统一用户标识user_tokenString64用于用户鉴权的临时token要求能够获取表13所述的数据：获取用户信息返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因user_inforJSON4096包含属性：name：姓名，Stringage：年龄，Integergender：性别，String，可选值M/Fweight：体重，Fload，一位小数，单位为公斤height：身高，Integer，单位为厘米max_heart_rate：最大心率，Integerheart_rate_zones：心率区间列表，包含的字段见heart_rate_zone字段说明risk_level：风险等级，Integer，取值为0-未测量血压1-风险级别低2-风险级别中等3-风险级别高taboos：列表，包含的字段见表14运动禁忌信息参数表字段名数据类型最大长度备注taboo_typeInteger32禁忌的运动类型参见表3taboo_descString512base64编码的字符串，用于说明禁忌的内容获取运动建议要求能够支持传入表15所述的数据：获取运动建议请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份user_uuidString64统一用户标识user_tokenString64用于用户鉴权的临时token要求能够获取表16所述的数据：获取运动建议返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因user_exercise_adviceJSON4096包含属性：suggest_gear_min：最低档位，只有律动设备有，Integersuggest_gear_max：最高档位，只有律动设备有，Integersuggest_intensity_zone_min：最低强度区间，Integersuggest_intensity_zone_max：最高强度区间，Integersuggest_hr_zone_min：最低心率区间，Integersuggest_hr_zone_max：最高心率区间，Integersuggest_duration_m_min：最低锻炼时长，Integer，单位为分钟suggest_duration_m_max：最高锻炼时长，Integer，单位为分钟exercise_risk：BASE64编码后的富文本运动风险提示（需要BASE64decode后使用）,String上传数据相关接口上传用户体测数据要求能够上传表17所述的数据：上传用户体测数据请求消息参数表参数名数据类型最大长度备注terminal_idString64终端id，用于验证请求发送方身份user_uuidString64统一用户标识user_tokenString64用于用户鉴权的临时tokenuser_examine_dataJSON1M用户体测数据格式详见表18体测数据格式说明表字段名称字段说明数据类型是否必填备注check_time体测时间DateTime必填yyyy-mm-ddhh:mi:sscheck_type体测类型Integer必填1–定期全面体测2–每日运动前体测3–每日运动后体测hight身高Float否weight体重Float否vital_capacity肺活量Integer否grip_strength握力Float否inflect体前屈Float否action_time反应时Float否single_foot_stand_time闭眼单脚站立Integer否blood_oxygen_saturation血氧浓度Float否pulse_rate脉率（单位是RPM）Integer否diastolic_pressure;舒张压Integer否systolic_pressure收缩压Integer否medicines_taking当日服用药物JSONArray否1–高血压药2–糖尿病药body_composition人体成分数据JSONObject否字段详见表19人体成分数据格式说明表参数名数据类型备注weiFloat体重heiFloat身高genInteger性别ageInteger年龄tbwFloat总体水ffmFloat去脂体重minFloat矿物质bmiFloat质量指数fatFloat脂肪量pbfFloat脂肪率musFloat肌肉量vfaFloat内脏脂肪面积whrFloat腰臀比proFloat蛋白质量smmFloat骨骼肌larmmFloat左手肌肉量rarmmFloat右手肌肉量llegmFloat左腿肌肉量rlegmFloat右腿肌肉量trmFloat躯干肌肉量evalarmmFloat上肢肌肉量评分evalfatFloat脂肪量评分evallegmFloat下肢肌肉量评分evalminFloat矿物质评分evalproFloat蛋白质评分scoreFloat总评分shapeInteger体型:1、低脂肪低体重2、低脂肪肌肉型3、运动员型4、低体重5、标准体型6、超重肌肉型7、隐形肥胖8、脂肪过量9、肥胖tarweiFloat目标体重ctrweiFloat体重控制ctrmusFloat肌肉控制ctrfatFloat脂肪控制bmrFloat基础代谢量cdayFloat每日所需热量maxweiFloat体重高值minweiFloat体重低值stdweiFloat体重标准值maxfatFloat脂肪重量高值minfatFloat脂肪重量低值stdfatFloat脂肪重量标准值maxffmFloat去脂体重高值minffmFloat去脂体重低值stdffmFloat去脂体重标准值maxtbwFloat总体水高值mintbwFloat总体水低值stdtbwFloat总体水标准值maxminFloat矿物质高值minminFloat矿物质低值stdminFloat矿物质标准值maxbmiFloat身体质量指数高值minbmiFloat身体质量指数低值stdbmiFloat身体质量指数标准值maxvfaFloat内脏脂肪面积高值minvfaFloat内脏脂肪面积低值stdvfaFloat内脏脂肪面积标准值maxwhrFloat腰臀比高值minwhrFloat腰臀比低值stdwhrFloat腰臀比标准值maxproFloat蛋白质高值minproFloat蛋白质低值stdproFloat蛋白质标准值maxarmmFloat上肢肌肉高值minarmmFloat上肢肌肉低值stdarmmFloat上肢肌肉标准值maxlegmFloat下肢肌肉高值minlegmFloat下肢肌肉低值stdlegmFloat下肢肌肉标准值maxtrmFloat躯干肌肉高值mintrmFloat躯干肌肉低值stdtrmFloat躯干肌肉标准值maxpbfFloat身体脂肪率高值minpbfFloat身体脂肪率低值stdpbfFloat身体脂肪率标准值maxsmmFloat骨骼肌高值minsmmFloat骨骼肌低值stdsmmFloat骨骼肌标准值ra5kFloat右手5kHz下阻抗数据la5kFloat左手5kHz下阻抗数据tr5kFloat全身5kHz下阻抗数据rl5kFloat右腿5kHz下阻抗数据ll5kFloat左腿5kHz下阻抗数据ra50kFloat右手50kHz下阻抗数据la50kFloat左手50kHz下阻抗数据tr50kFloat全身50kHz下阻抗数据rl50kFloat右腿50kHz下阻抗数据ll50kFloat左腿50kHz下阻抗数据ra250kFloat右手250kHz下阻抗数据la250kFloat左手250kHz下阻抗数据tr250kFloat全身250kHz下阻抗数据rl250kFloat右腿250kHz下阻抗数据ll250kFloat左腿250kHz下阻抗数据要求能够返回表20所述的数据：上传用户体测数据返回消息参数表参数名数据类型最大长度备注resp_codeInteger32返回码，用于解读处理结果0表示处理成功无错误resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因上传运动数据要求能够上传表21所述的数据：上传运动数据请求消息参数表参数名数据类型最大长度参数说明terminal_idString64终端id，用于验证请求发送方身份device_typeInteger32设备类型，可选的设备类型见表22user_uuidString64统一用户标识user_tokenString64用于用户鉴权的临时tokenuser_exercise_dataJSONString1M此字段不参与签名力量类的设备上传的数据格式详见表22有氧类的设备上传的数据格式详见表24律动类的设备上传的数据格式详见表25力量设备上传的运动数据字段说明表字段名数据类型最大长度备注total_duration_sInteger32锻炼时间总长度（单位为秒）total_kcalFloat32锻炼消耗卡路里总量（单位为kcal）total_weightFloat32运动总量（单位是kg）total_move_timesInteger32总动作次数（单位是次）tota_group_timesInteger32锻炼总组数groupsJSONArray4096一次锻炼中各组的数据，内容表23力量设备每组运动数据字段说明表字段名数据类型最大长度备注duration_sInteger32锻炼时间长度（单位为秒）kcalFloat32锻炼消耗卡路里（单位为kcal）weightFloat32重量（一组是同一个重量，单位为kg）move_timesFloat32动作次数（单位是次）有氧设