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

35.240.80CCS

L

09登记号：XXXXX T/SIOT

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

care

-

Technical

indoor

sports

healthmonitoring

exercise

data

上

海

市

物

联

网

行

业

协

会 发

布T/SIOT

313-2021 前言

.................................................................................

II1

...............................................................................

32 规范性引用文件

.....................................................................

33 术语和定义

.........................................................................

34 缩略语

.............................................................................

45

.............................................................

45.1 系统结构

.......................................................................

45.2 数据接口分类

...................................................................

56 数据接口的安全性要求

...............................................................

66.1 数据接口的数据加密要求

.........................................................

66.2 数据接口的数据完整性要求

.......................................................

67

.............................................................

67.1 通用要求

.......................................................................

67.1.1 统一用户标识

...............................................................

67.1.2 状态码及错误信息

...........................................................

67.1.3 设备类型

...................................................................

77.2 信息同步相关接口

...............................................................

97.2.1 传入用户信息

...............................................................

97.3 识别用户身份相关接口

..........................................................

107.3.1 识别用户身份

..............................................................

107.3.2 上传人脸照片

..............................................................

107.3.3

........................................................

117.4 获取用户信息相关接口

..........................................................

117.4.1 获取用户信息

..............................................................

117.4.2 获取运动建议

..............................................................

127.5 上传数据相关接口

..............................................................

137.5.1 上传用户体测数据

..........................................................

137.5.2 上传运动数据

..............................................................

17参考文献

.............................................................................

19T/SIOT

313-2021 本文件按照GB/T

—《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由上海市物联网行业协会提出并归口。互联网有限公司、电信科学技术第一研究所有限公司、迪爱斯信息技术股份有限公司。本标准主要起草人：王海龙、周微、叶晓华、卢文云、徐敏、徐一涵、袁江枫、姚丽莹、保志军、莉琴。海陆道智城文化创意产业集团股份有限公司、上海长庚家庭服务有限公司。IIT/SIOT

313-2021 1 范围结构与接口分类、数据接口的安全性要求、数据接口的消息格式要求等。本文件适用于智慧健康养老领域室内运动场馆的运营管理系统与智能健康监测设备和智能运动器械之间的数据通讯接口设计。2 规范性引用文件文件。GB

17859—1999

计算机信息系统

安全保护等级划分准则GB/T

20270—2006

信息安全技术

网络基础安全技术要求GB/T

20271—2006

信息安全技术

信息系统通用安全技术要求JGJ/T484—2019

养老服务智能化系统技术标准T/CSGF

004—2018

智慧化健身场所技术规范3 术语和定义下列术语和定义适用于本文件。3.1数据接口

data

interface决软件之间的兼容性问题。3.2场馆运营管理系统

venue

operation

management

的进行内部管理、及时准确的把握场馆的经营状况。3.3智能健康监测设备

health

equipment康监测设备不具备的功能。3.4智能运动器械

sports

equipment运动数据的上传等传统运动器械不具备的功能。T/SIOT

313-20214 缩略语下列缩略语适用于本文件。HTTPS

超文本传输安全协议（Hyper

Text

Transfer

Protocol

over

SecureSocket

Layer）JSON

JavaScript

Notation）UUID

通用唯一识别码（

Unique

）Wi-Fi

无线局域网（Wireless

Fidelity）5 系统结构及数据接口分类5.1 系统结构1动提供支持，如建立和查看用户健康档案等。智能健康监测设备和智能运动器械部署在场馆内，通过Wi-Fi、以太网的方式接入到互联网，与场馆运营管理系统通讯，实现身份鉴别、用户信息下发、运动据和运动数据。图1 系统结构图接口分类接口名称接口说明T/SIOT

313-20215.2 数据接口分类系统中涉及的数据接口分类见表1。表1 系统接口分类表接口分类接口名称接口说明T/SIOT

313-20216 数据接口的安全性要求6.1 数据接口的数据加密要求应对在数据接口间传输的数据进行保密性保护。6.2 数据接口的数据完整性要求情况发生。7 数据接口的消息格式要求7.1 通用要求7.1.1 统一用户标识UUID的生成方法必须遵循由开放软件基金会(OSF)制定的RFC4122标准，以保证对在同一时空中的所有机器都是唯一的。7.1.2 状态码及错误信息用的状态码定义见表2。错误代码分类错误代码说明1-999保留给各接口自定义业务流程中出现的失败，如用户名错1001

id1002

100310042001

id

2002

token

token

3001300290019999设备大类名称设备类型名称设备类型编号0100101002010030100401005T/SIOT

313-2021表2 通用返回状态码表7.1.3 设备类型各接口中有设备类型编号确定上传数据的设备类型，其编号规则为两位数字的设备大类编号+数字的设备具体类型编号。其中设备大类编号为： 01：功能性有氧； 02：微循环促进； 03：等速肌力； 04：柔韧拉伸； 05：单功能力量。相同的设备类型编号。各接口中涉及到设备类型的字段，设备类型名称和设备类型编号的对应关系见表3.表3 设备类型信息表设备大类名称设备类型名称设备类型编号0200102002020030200403001030020300303004030050300603007030080400104002040030400404005040060500105002050030500405005050060500705008坐姿后仰腰背训练器0500905010050110501205013T/SIOT

313-2021设备大类名称设备类型名称设备类型编号050140501505016050170501805019050200502105022高拉、低拉双功能训练器050230502405025050260502705028参数名数据类型最大长度参数说明terminal_idString64

iduser_uuidString64nameString32id_card_noString32mobile_numberString16String64参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因T/SIOT

313-20217.2 信息同步相关接口7.2.1 传入用户信息用于在不同的场馆运营系统之间，同步用户的数据。要求能够支持传入表4所述的数据：表4 传入用户信息请求消息参数表要求能够返回表5所述的数据：表5要求能够返回表5所述的数据：参数名数据类型最大长度参数说明terminal_idString64

idstore_idString64

IDauth_typeInteger32

auth_credentialString641.

2.

如果是人脸识别需要先上传照片后再上送照3.

’|’参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因user_uuidString64user_tokenString64

user_token_thrutimeLong64

参数名数据类型最大长度参数说明terminal_idString64

idT/SIOT

313-20217.3 识别用户身份相关接口7.3.1 识别用户身份用于智能健康监测设备和智能运动器械，向场馆运营系统查询用户的身份。要求能够支持传入表6所述的数据：表6 识别用户身份请求消息参数表要求能够返回表7所述的数据。表7要求能够返回表7所述的数据。7.3.2 上传人脸照片份。要求能够支持传入表8所述的数据。表8 上传人脸照片请求消息参数表10参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096barcode_contentString4096参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因image_file_nameString64参数名数据类型最大长度参数说明image_file_typeString32image_fileFile8M参数名数据类型最大长度参数说明terminal_idString64

idString64

id参数名数据类型最大长度参数说明terminal_idString64

iduser_uuidString64T/SIOT

313-2021要求能够返回表9所述的数据。表9要求能够返回表9所述的数据。7.3.3 获取用户登录二维码身份。要求能够支持传入表10所述的数据：表10 获取用户登录二维码请求消息参数表要求能够返回表11所述的数据。表11要求能够返回表11所述的数据。7.4 获取用户信息相关接口7.4.1 获取用户信息表12所述的数据。表12 获取用户信息请求消息参数表11参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因user_inforString4096

JSON

‐

name‐

age‐

gender

‐

weightFloat‐

height‐

‐

‐

risk_level•

•

•

•

‐

taboos

14参数名数据类型最大长度参数说明terminal_idString64

iduser_uuidString64user_tokenString64

字段名数据类型最大长度参数说明taboo_typeInteger32

taboo_descString512base64

参数名数据类型最大长度参数说明user_tokenString64

T/SIOT

313-2021要求能够获取表13所述的数据。表13要求能够获取表13所述的数据。表14 运动禁忌信息参数表7.4.2 获取运动建议表15所述的数据。表15 获取运动建议请求消息参数表要求能够获取表16要求能够获取表16所述的数据。参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096返回消息，出错时返回，用于辅助解读错误的原因String4096

JSON

‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

exercise_risk

decode

,String参数名数据类型最大长度参数说明terminal_idString64

iduser_uuidString64user_tokenString64

user_examine_dataString1M

JSON

18T/SIOT

313-2021表16 获取运动建议返回消息参数表7.5 上传数据相关接口7.5.1 上传用户体测数据17所述的数据。表17 上传用户体测数据请求消息参数表13字段名称字段说明数据类型是否必填参数说明check_timeDateTimeyyyy-mm-dd

hh:mi:sscheck_typeInteger

hightFloatweightFloatIntegergrip_strengthFloatinflectFloataction_timeFloatIntegerblood_oxygen_saturationFloatpulse_rateIntegerdiastolic_pressure;Integersystolic_pressureIntegerString

JSON

String

JSON

19参数名数据类型参数说明weiFloatheiFloatgenIntegerageIntegertbwFloatffmFloatminFloatbmiFloatfatFloatpbfFloatmusFloatvfaFloatwhrFloatproFloatsmmFloatT/SIOT

313-2021表18 体测数据格式说明表表19 人体成分数据格式说明表14参数名数据类型参数说明larmmFloatrarmmFloatllegmFloatrlegmFloattrmFloatevalarmmFloatevalfatFloatevallegmFloatevalminFloatevalproFloatscoreFloatshapeIntegertarweiFloatctrweiFloatctrmusFloatctrfatFloatbmrFloatcdayFloatmaxweiFloatminweiFloatstdweiFloatmaxfatFloatminfatFloatstdfatFloatmaxffmFloatminffmFloatstdffmFloatmaxtbwFloatmintbwFloatstdtbwFloatmaxminFloatminminFloat1515T/SIOT

313-2021参数名数据类型参数说明stdminFloatmaxbmiFloatminbmiFloatstdbmiFloatmaxvfaFloatminvfaFloatstdvfaFloatmaxwhrFloatminwhrFloat腰臀比低值stdwhrFloatmaxproFloatminproFloatstdproFloatmaxarmmFloatminarmmFloatstdarmmFloatmaxlegmFloatminlegmFloatstdlegmFloatmaxtrmFloatmintrmFloatstdtrmFloatmaxpbfFloatminpbfFloatstdpbfFloatmaxsmmFloatminsmmFloatstdsmmFloatra5kFloat

5kHz

la5kFloat

5kHz

tr5kFloat

5kHz

rl5kFloat

5kHz

ll5kFloat

5kHz

ra50kFloat

la50kFloat

tr50kFloat

rl50kFloat

ll50kFloat

ra250kFloat

250kHz

la250kFloat

250kHz

T/SIOT

313-202116参数名数据类型最大长度参数说明terminal_idString64

iddevice_typeInteger32

22user_uuidString64user_tokenString64

String1M

JSON

22有氧类的设备上传的数据格式详见表

24

25字段名数据类型最大长度参数说明Integer32total_kcalFloat32

kcaltotal_weightFloat32

kgInteger32Integer32groupsString4096

JSON

23参数名数据类型参数说明tr250kFloat

250kHz

rl250kFloat

250kHz

ll250kFloat

250kHz

参数名数据类型最大长度参数说明resp_codeInteger32

resp_msgString4096字段名数据类型最大长度参数说明duration_sInteger32T/SIOT

313-2021要求能够返回表20所述的数据。表20要求能够返回表20所述的数据。7.5.2 上传运动数据明见表22-表25。表21 上传运动数据请求消