GBT 40688-2021 物联网 生命体征感知设备数据接口

物联网生命体征感知设备数据接口2021-10-11发布国家标准化管理委员会I前言 2规范性引用文件 13术语和定义 4缩略语 25总则 25.1通信协议 25.2接口描述 25.3编码字符集 25.4数据类型 26接口消息格式 26.1请求消息格式 26.2响应消息格式 37通用接口基本功能和参数 47.1请求类接口 47.2事件推送类接口 8业务接口基本功能和参数 8.1心率类 8.2血压类 8.3体温类 8.4呼吸类 8.5血氧饱和度类 附录A(资料性)生命体征感知设备通用数据接口参数JSON代码示例 参考文献 Ⅲ本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本文件起草单位：中国电子技术标准化研究院、北京一未网络科技有限公司、深圳赛西信息技术有限公司、北京赛思美科技术有限公司、上海笛乐护斯健康科技有限公司、北京邮电大学、深圳市北测检测技术有限公司、安徽华米信息科技有限公司、北京曙光易通技术有限公司、无锡识凌科技有限公司、中国医学科学院生物医学工程研究所、京东方科技集团股份有限公司、小米通讯技术有限公司、福州物联网开放实验室有限公司、军事科学院系统工程研究院后勤科学与技术研究所、江南大学附属医院、山东大学齐鲁医院、山东大学控制科学与工程学院、福建省晋江市华宇织造有限公司、海西纺织新材料工业技术晋江研究院、宁夏互联网医疗健康标准化研究有限公司、龙腾半导体股份有限公司、北京裕成泰科技有限公司、北京智芯微电子科技有限公司、重庆邮电大学、苏州寻息电子科技有限公司、延安大学附属医院、山东省人工智能研究院、福建东方物联信息科技有限公司、杭州医锐联科技有限公司。1物联网生命体征感知设备数据接口本文件规定了面向物联网应用的生命体征感知设备到生命体征监测系统的数据接口的总则、接口消息格式以及通用接口和业务接口的基本功能和参数的要求。本文件适用于面向物联网应用的生命体征感知设备的设计、生产和使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T13000—2010信息技术通用多八位编码字符集(UCS)RFC2616超文本传输协议1.1(HypertextTransferProtocol-HTTP/1.1)RFC4627JSON应用与媒体类型[Theapplication/jsonMediaTypeforJavaScriptObjectNota-tion(JSON)]3术语和定义下列术语和定义适用于本文件。用于判定人体生命特征的指征。注1:生命体征可进行测量，指标的正常范围因种族、性别、年龄、体重而异。注2:包括但不限于体温、血压、心率、呼吸和血氧饱和度五种。生命体征感知设备vitalsignssensingdevice能够获取生命体征数据的设备或者根据生命体征数据获得生命体征状态的面向物联网应用的设备。注：一般具有数据采集、数据处理和通信能力。生命体征监测系统vitalsignsmonitoringsystem接收、处理和存储生命体征感知数据，为个人、家庭、医疗机构及其他用户提供生命体征监测管理服务，并能配置生命体征感知设备的信息系统。编码字符集codecharacterset一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。交易transaction生命体征感知设备与生命体征监测系统双方通信交互的过程。2描述生命体征感知设备或生命体征监测系统自身所属的特征信息值。4缩略语下列缩略语适用于本文件。GMT:格林威治时间(GreenwichMeanTime)HTML:超文本置标语言(HyperTextMarkupLanguage)HTTP:超文本传输协议(HyperTextTransferProtocol)HTTPS:超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer或Hy-pertextTransferProtocolSecure)ID:标识符(Identifier)JSON:轻量级的数据交换格式(JavaScriptObjectNotation)MIME:多用途互联网邮件扩展(MultipurposeInternetMailExtensions)5总则5.1通信协议生命体征感知设备接口通信协议应采用符合RFC2616的HTTP或HTTPS。5.2接口描述生命体征感知设备接口的描述宜使用标准化的或比较通用的文本描述语言，例如JSON(RFC4627)。附录A给出了本文件描述的各类接口的参数示例的JSON代码表示。5.3编码字符集编码字符集使用UTF-8,应符合GB/T13000—2010的要求。5.4数据类型生命体征感知设备接口应覆盖所能支持数据类型，包括：——字符串型(String),——对象型(Object),——数组型(Array),——布尔型(Boolean),注：对请求参数中“时间”类信息，以“1970年1月1日，00:00:00(GMT时间)”作为基准起始时间。6接口消息格式6.1请求消息格式请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。36.1.2请求头不同接口具有同一请求头，请求头的名称及其含义描述应符合表1。表1请求头必选/可选Host指定请求的服务器的域名和端口号必选Connection表示是否需要持久连接必选Accept表示接受所接收的内容类型必选Content-type请求的与实体对应的MIME信息必选Content-Length请求的内容长度必选CookieHTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器可选User-agent内容包含发出请求的用户信息可选6.1.3请求参数请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。示例：参数名数据类型必选/可选描述给出该字段所代表的参数名用于描述数据的数据类型描述该参数是否为必选对参数的描述及补充说明6.2响应消息格式6.2.1消息格式响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。不同接口具有同一响应头，响应头的名称及其含义描述应符合表2。表2响应头必选/可选Content-type请求的与实体对应的MIME信息必选Content-Length请求的内容长度必选服务器消息发出的时间可选服务器软件名称可选6.2.3响应消息参数响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。4参数名数据类型必选/可选描述给出该字段所代表的参数名用于描述数据的数据类型描述该参数是否为必选对参数的描述及补充说明7通用接口基本功能和参数7.1请求类接口生命体征监测系统从生命体征感知设备请求数据或为生命体征感知设备设置数据的接口流程应符合图1。此类接口流程是：a)生命体征监测系统发出请求(即请求生命体征感知设备提供数据，请求生命体征感知设备接受为其所做的设置);b)生命体征感知设备对该次请求进行处理；c)处理后由生命体征感知设备向生命体征监测系统返回处理结果。生命体征监测系统生命体征监测系统互联网POST()请求JITTP/TITTPSPOST()返回图1请求类接口流程7.1.2请求类接口列表请求类接口应符合表3。表3请求类接口列表中文名称英文名称必选/可选初始化连通可选建立会话必选关闭会话必选关闭设备可选5表3请求类接口列表(续)中文名称英文名称必选/可选重启设备restart可选重置设备reset可选获取设备属性必选设置设备属性可选获取帮助help必选获取事件getevent可选触发事件可选7.1.3请求类接口基本功能和参数用于与生命体征感知设备间建立初始化连通。初始化连通请求参数应符合表4,JSON代码示例见A.1。表4初始化连通请求参数参数名数据类型必选/可选描述必选命令名称必选目标设备ID必选物联网接入方ID必选appid对应密匙加密的字符串加密后明文version可选版本ID,默认值为1.0必选会话IDNumber必选交易时间Number可选交易ID初始化连通响应消息参数应符合表5,JSON代码示例见A.1。6表5初始化连通响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息guidString必选目标设备IDString必选appid对应密匙加密的字符串加密后明文appidString必选物联网接入方IDtokenString必选调用者的令牌Number必选交易时间Number可选交易ID用于生命体征感知设备建立会话，获取会话信息。建立会话请求参数应符合表6,JSON代码示例见A.2。表6建立会话请求参数参数名数据类型必选/可选描述必选打开会话必选物联网连接方IDredirect-uri可选重定向地址response_type可选响应类型可选传入redirect-uri的附加参数可选调用者的令牌可选应用授权作用域version可选版本ID,默认值为1.0必选设备唯一识别号必选会话IDNumber必选交易时间Number可选交易ID建立会话响应消息参数应符合表7,JSON代码示例见A.2。7表7建立会话响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息String必选设备IDString必选会话ID,如：Number必选交易时间Number可选交易ID用于生命体征感知设备关闭会话。关闭会话请求参数应符合表8,JSON代码示例见A.3。表8关闭会话请求参数参数名数据类型必选/可选描述必选命令名称Object/Array可选自定义元素必选会话IDNumber必选交易时间Number可选交易ID关闭会话响应消息参数应符合表9,JSON代码示例见A.3。表9关闭会话响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID8关闭生命体征感知设备。关闭设备请求参数应符合表10,JSON代码示例见A.4。表10关闭设备请求参数参数名数据类型必选/可选描述必选命令名称可选自定义元素必选Number必选交易时间Number可选关闭设备响应消息参数应符合表11,JSON代码示例见A.4。表11关闭设备响应消息参数参数名数据类型必选/可选描述必选交易响应代码errmsg可选交易响应信息可选数据对象属性Number必选交易时间Number可选重启生命体征感知设备。重启设备请求参数应符合表12,JSON代码示例见A.5。9表12重启设备请求参数参数名数据类型必选/可选描述String必选命令名称optionObject/Array可选自定义元素String必选Number必选交易时间Number可选交易ID重启设备响应消息参数应符合表13,JSON代码示例见A.5。表13重启设备响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID重置生命体征感知设备。重置设备请求参数应符合表14,JSON代码示例见A.6。表14重置设备请求参数参数名数据类型必选/可选描述reset必选命令名称argsObject/Array可选自定义元素必选会话IDNumber必选交易时间Number可选交易ID重置设备响应消息参数应符合表15,JSON代码示例见A.6。表15重置设备响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID获取生命体征感知设备相关属性。获取设备属性请求参数应符合表16,JSON代码示例见A.7。表16获取设备属性请求参数参数名数据类型必选/可选描述必选命令名称propertyArray必选属性的节点字符串数组，如："property":["version","value"],属性值优先采用字符串表示，厂商可自定义属性，并在帮助信息中加入说明必选会话IDNumber必选交易时间Number可选交易ID获取设备属性响应消息参数应符合表17,JSON代码示例见A.7。表17获取设备属性响应消息参数参数名数据类型必选/可选描述必选交易响应代码可选交易响应信息必选属性键值对，如："data":{"version":"1.0",Number必选交易时间Number可选设置生命体征感知设备相关属性。设置设备属性请求参数应符合表18,JSON代码示例见A.8。表18设置设备属性请求参数参数名数据类型必选/可选描述必选命令名称argsproperty必选属性值类型和具体的属性相关，如："args":{"property":{"value":"100","ver-必选会话IDNumber必选交易时间Number可选交易ID设置设备属性响应消息参数应符合表19,JSON代码示例见A.8。表19设置设备属性响应消息参数参数名数据类型必选/可选描述必选交易响应代码可选交易响应信息可选数据对象属性Number必选交易时间Number可选获取生命体征感知设备交易方包括函数、权限、交易格式等基础信息。获取帮助请求参数应符合表20,JSON代码示例见A.9。表20获取帮助请求参数参数名数据类型必选/可选描述必选命令名称nameArray必选获取参数说明，如："args”:{"name":["关键字1","关键字2"…]必选会话IDNumber必选交易时间Number可选交易ID获取物联网交易帮助响应消息参数应符合表21,JSON代码示例见A.9。表21获取物联网交易帮助响应消息参数参数名数据类型必选/可选描述必选交易响应代码可选交易响应信息必选函数或属性名称必选默认值或默认行为必选属性值类型必选文字描述可选函数返回值描述example可选示例说明uri可选外部文档HTTP(S)链接，如："data”:{”name":"version","type":"String","default":"1.0","uri":"/help","example":"示例如下：“,"summary":"version属性"}Number必选交易时间Number可选交易ID获取生命体征感知设备事件，如果不设置事件回调参数，可以通过该方法获取指定事件。获取事件请求参数应符合表22,JSON代码示例见A.10。表22获取事件请求参数参数名数据类型必选/可选描述必选命令名称Array必选事件节点，如："args":{"type":["change"]}必选会话IDNumber必选交易时间Number可选交易ID获取事件响应消息参数应符合表23,JSON代码示例见A.10。表23获取事件响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息Object/Array可选事件对象数组，如："list":[{"evt":"事件推送类型”,"args":事件参数，"sender":"事件触发者","time":触发时间}]Number必选交易时间Number可选交易ID触发生命体征感知设备事件，比如按键事件，事件参数定义兼容HTML事件。触发事件请求参数应符合表24,JSON代码示例见A.11。表24触发事件请求参数参数名数据类型必选/可选描述必选命令名称Object/Array必选事件对象数组，如："list":[{"evt送类型","args":事件参数，"sender":"事件触发者"}]必选会话IDNumber必选交易时间Number可选交易ID触发事件响应消息参数应符合表25,JSON代码示例见A.11。表25触发事件响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码String可选交易响应信息Array可选事件数组，每个事件的处理情况Number必选交易时间Number可选交易ID7.2事件推送类接口生命体征感知设备推送设备采集信息到生命体征监测系统的接口流程应符合图2。此类接口流程为：a)生命体征感知设备请求生命体征监测系统接收该设备采集的数据；b)生命体征监测系统对该次请求进行处理：c)处理后生命体征监测系统向生命体征感知设备返回处理结果。生命体征监测系统生命体征监测系统互联网POST()请求HTTP/H'TIPS请求图2事件推送类接口交易流程7.2.2事件推送类接口列表事件推送类接口应符合表26。表26事件推送类接口列表中文名称英文名称必选/可选错误事件error可选点击事件可选按键事件可选重要属性项发生改变可选主动推送属性值(即便没有发生改变)可选7.2.3设备端事件推送接口基本功能和参数当生命体征感知设备相关属性发生变化或根据设备定义推送交易到生命体征监测系统。设备端事件推送消息参数应符合表27,JSON代码示例见A.12。表27设备端事件推送请求参数参数名数据类型必选/可选描述error/click/keydown/必选事件名称必选设备IDargsObject/Array必选事件对象必选会话IDNumber必选交易时间Number可选交易ID设备端事件推送响应消息参数应符合表28,JSON代码示例见A.12。表28设备端事件推送响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID8业务接口基本功能和参数8.1心率类请求方获取生命体征感知设备心率值信息，并可通过定义函数方式获取心率值。获取心率信息请求参数应符合表29。表29获取心率信息请求参数参数名数据类型必选/可选描述String必选命令名称propertyArray必选"property":["heart-rate"],其中heart-rate是必选项String必选会话IDNumber必选交易时间Number可选交易ID获取心率信息响应消息参数应符合表30。表30获取心率信息响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息heart-rateString必选心率值，单位：次/minuser-defineObject可选用户自定义属性Number必选交易时间Number可选请求方获取生命体征感知设备心电序列信息。获取心电信息请求参数应符合表31。表31获取心电信息请求参数参数名数据类型必选/可选描述String必选命令名称propertyArray必选"property":["ecg","timescope-h"],其中ecg为必选项String必选Number必选交易时间Number可选交易ID获取心电信息响应消息参数应符合表32。表32获取心电信息响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息String必选心电采集点采样频率，精度为毫秒级；voltagescopeString必选心电采样电压范围，单位：mVheart-rateString必选心率值，单位：次/minArray必选采集心电电压组，单位：mVuser-defineObject/Array可选用户自定义属性Number必选交易时间Number可选交易ID8.1.3推送心率信息设备端推送生命体征感知设备心率数据到生命体征监测系统。推送心率信息请求参数应符合表33。表33推送心率信息请求参数参数名数据类型必选/可选描述必选命令名称必选必选心率值，单位：次/min必选Number必选交易时间Number可选推送心率信息响应消息参数应符合表34。表34推送心率信息响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Obiect/Array可选数据对象属性Number必选交易时间Number可选设备端推送生命体征感知设备心电信息到生命体征监测系统。推送心电信息请求参数应符合表35。表35推送心电信息请求参数参数名数据类型类型必选/可选描述changeString必选命令名称String必选String必选心电采集点采样频率，精度为毫秒级；voltagescopeString必选心电采样电压范围，单位：mVheart-rateString必选心率值，单位：次/minArray必选采集心电电压组，单位：mVuser-defineObject/Array可选用户自定义属性表35推送心电信息请求参数(续)参数名数据类型类型必选/可选描述必选会话IDNumber必选交易时间Number可选交易ID推送心电信息响应消息参数应符合表36。表36推送心电信息响应消息参数参数名数据类型必选/可选描述必选交易响应代码可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID8.2血压类8.2.1获取血压信息请求方获取生命体征感知设备血压(收缩压与舒张压)信息，并可通过定义函数方式获取血压值。获取血压信息请求参数应符合表37。表37获取血压信息请求参数参数名数据类型必选/可选描述String必选命令名称propertyArray必选如："property":["sbp","dbp","time"]String必选会话IDNumber必选交易时间Number可选交易ID获取血压信息响应消息参数应符合表38。表38获取血压信息响应消息参数参数名数据类型必选/可选描述必选交易响应代码errmsg可选交易响应信息必选收缩压值，单位：mmHg必选舒张压值，单位：mmHg必选测量时间，单位：sNumber必选交易时间Number可选交易ID8.2.2获取连续血压信息请求方获取生命体征感知设备连续血压信息。请求参数获取连续血压信息请求参数应符合表39。表39获取连续血压信息请求参数参数名数据类型必选/可选描述必选命令名称propertyArray必选获取连续血压数据(bp)、连续血压数据采集mescope"]必选会话IDNumber必选交易时间Number可选交易ID响应消息参数获取连续血压信息响应消息参数应符合表40。表40获取连续血压信息响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息表40获取连续血压信息响应消息参数(续)参数名数据类型必选/可选描述Number必选血压采集点采样频率，精度为毫秒级String必选动态收缩压值，单位：mmHgString必选动态舒张压值，单位：mmHgpulse-rateObject/Array必选脉率值，单位：次/minuser-defineObject/Array可选用户自定义属性Number必选交易时间Number可选交易ID8.2.3推送血压信息设备端推送生命体征感知设备血压数据到生命体征监测系统。推送血压信息请求参数应符合表41。表41推送血压信息请求参数参数名数据类型必选/可选描述evtchangeString必选命令名称String必选设备IDargsString必选收缩压值，单位：mmHgString必选舒张压值，单位：mmHgNumber必选测量时间，单位：sString必选会话IDNumber必选交易时间Number可选推送血压信息响应消息参数应符合表42。表42推送血压信息响应消息参数参数名数据类型必选/可选描述String必选交易响应代码String可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID8.2.4推送连续血压信息设备端推送生命体征感知设备连续血压数据到生命体征监测系统。推送连续血压信息请求参数应符合表43。表43推送连续血压信息请求参数参数名数据类型必选/可选描述必选命令名称必选argsNumber必选血压采集点采样频率，精度为毫秒值必选动态收缩压值，单位：mmHg必选动态舒张压值，单位：mmHg必选脉率值，单位：次/min可选用户自定义属性必选Number必选交易时间Number可选推送连续血压信息响应消息参数应符合表44。表44推送连续血压信息响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID8.3体温类请求方获取生命体征感知设备体温信息，并可通过定义函数方式获取体温值。获取体温信息交易请求参数应符合表45。表45获取体温信息交易请求参数参数名数据类型必选/可选描述String必选命令名称propertyArray必选”property":[”temperature"],其中temperature为必选项String必选Number必选交易时间Number可选交易ID获取体温信息交易响应消息参数应符合表46。表46获取体温信息交易响应消息参数参数名数据类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息temperatureString必选体温值，单位：℃user-defineObject/Array可选用户自定义属性Number必选交易时间Number可选交易ID设备端推送生命体征感知设备体温数据到生命体征监测系统。推送体温信息请求参数应符合表47。表47推送体温信息请求参数参数名数据类型必选/可选描述changeString必选命令名称String必选argstemperatureString必选体温值，单位：℃表47推送体温信息请求参数(续)参数名数据类型必选/可选描述必选会话IDNumber必选交易时间Number可选交易ID推送体温信息响应消息参数应符合表48。表48推送体温信息响应消息参数字段类型必选/可选描述必选交易响应代码可选交易响应信息可选数据对象属性Number必选交易时间Number可选8.4.1获取呼吸频率信息请求方获取生命体征感知设备呼吸频率信息，并可通过定义函数方式获取呼吸率值等信息。获取呼吸频率信息请求参数应符合表49。表49获取呼吸频率信息请求参数字段类型必选/可选描述String必选命令名称propertyArray必选自定义元素，如：amplitude"]String必选会话IDNumber必选交易时间Number可选交易ID获取呼吸频率信息响应消息参数应符合表50。表50获取呼吸频率信息响应消息参数字段类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息respiratory-rateString必选呼吸频率值，单位：次/minrespiratory-amplitudeString必选呼吸幅度值，单位：gNumber必选交易时间Number可选8.4.2获取呼吸波信息请求方获取生命体征感知设备呼吸波序列信息。获取呼吸波信息请求参数应符合表51。表51获取呼吸波信息请求参数字段类型必选/可选描述String必选命令名称argspropertyArray必选"property":["respiratory-wave","timescoper"],其中respiratory-wave为必选项String必选会话IDNumber必选交易时间Number可选交易ID获取呼吸波信息响应消息参数应符合表52。表52获取呼吸波信息响应消息参数字段类型必选/可选描述String必选交易响应代码errmsgString可选交易响应信息表52获取呼吸波信息响应消息参数(续)字段类型必选/可选描述Number必选呼吸频率值，单位：次/minrespiratory-rateString呼吸幅度值，单位：grespiratory-amplitudeString呼吸幅度值，单位：grespiratory-waveObject/Array呼吸波对象user-defineObject/Array用户自定义属性Number必选交易时间Number可选8.4.3推送呼吸频率信息设备端推送生命体征感知设备呼吸频率数据到生命体征监测系统。推送呼吸频率信息请求参数应符合表53。表53推送呼吸频率信息请求参数字段类型必选/可选描述changeString必选命令名称String必选argsrespiratory-rateString必选呼吸频率值，单位：次/minrespiratory-amplitudeString必选呼吸幅度值，单位：gString必选Number必选交易时间Number可选交易ID响应消息参数推送呼吸频率信息响应消息参数应符合表54。表54推送呼吸频率信息响应消息参数字段类型必选/可选描述必选交易响应代码可选交易响应信息可选数据对象属性Number必选交易时间Number可选8.4.4推送呼吸波信息设备端推送生命体征感知设备呼吸波数据到生命体征监测系统。推送呼吸波信息请求参数应符合表55。表55推送呼吸波信息请求参数字段类型必选/可选描述changeString必选命令名称String必选argsNumber必选呼吸频率值，单位：次/minrespiratory-rateString必选呼吸幅度值，单位：grespiratory-amplitudeString必选呼吸幅度值，单位：grespiratory-waveObject/Array必选呼吸波对象user-defineObject/Array可选用户自定义属性String必选会话IDNumber必选交易时间Number可选推送呼吸波信息响应消息参数应符合表56。表56推送呼吸波信息响应消息参数字段类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选8.5血氧饱和度类8.5.1获取血氧饱和度信息请求方获取生命体征感知设备血氧饱和度信息，并可通过定义函数方式获取血氧饱和度值。获取血氧饱和度信息请求参数应符合表57。表57获取血氧饱和度信息请求参数字段类型必选/可选描述String必选命令名称propertyArray必选"property":["spo2"],其中spo2为必选项String必选会话IDNumber必选交易时间Number可选交易ID获取血氧饱和度信息响应消息参数应符合表58。表58获取血氧饱和度信息响应消息参数字段类型必选/可选描述errcodeString必选交易响应代码errmsgString可选交易响应信息String必选血氧饱和度值，单位：%user-defineObject/Array可选用户自定义属性Number必选交易时间Number可选8.5.2推送血氧饱和度信息设备端推送生命体征感知设备血氧饱和度数据到服务端。推送血氧饱和度信息请求参数应符合表59。表59推送血氧饱和度信息请求参数字段类型必选/可选描述String必选命令名称String必选设备IDString必选血氧饱和度值，单位：%表59推送血氧饱和度信息请求参数(续)字段类型必选/可选描述必选会话IDNumber必选交易时间Number可选交易ID推送血氧饱和度信息响应消息参数应符合表60。表60推送血氧饱和度信息响应消息参数字段类型必选/可选描述String必选交易响应代码String可选交易响应信息Object/Array可选数据对象属性Number必选交易时间Number可选交易ID(资料性)生命体征感知设备通用数据接口参数JSON代码示例本附录给出各个接口的参数JSON代码示例。所有示例中出现的实体名称仅仅是供举例用。A.1初始化连通A.1.1请求示例POST/cn.stdiot.driverHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:175{"cmd":"token","args":{"option":{"guid":"cn.ehiot.driver.1.0","appid":"appid","echo":A.1.2响应示例Content-Length:193Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{{"data":{"appid":"appid","guid":"cn.ehiot.driver.1.0","token":"1569241617652","echo":"appid对应密匙解密的一个随机字符串"}},"errcode":"200","errmsg":"","tid":1,"time":A.2建立交易会话A.2.1请求示例POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:268{"cmd":"open","args":{"option":{"appid":"appid","redirect-uri":"http://localhost:8084/ehiot/cn.ehiot.simulator","response_type":"code","state":"state","scope":"scope","token":"to-ken","version":"1.0","guid":"cn.ehiot.driver.1.0"}},"tid":2,"sid":"","time":1569244129944}ontent-Length:141Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{"data":{"guid":"cn.ehiot.driver.1.0","sid":"380b7007-642b-4670-8782-5a3ab900a8fb"},"er-rcode":"200","errmsg":"","tid":2,"time":1569244437475}A.3.1请求示例POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:110{"cmd":"close","args":{"option":{}},"tid":3,"sid":"380b7007-642b-4670-8782-Content-Length:68Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{"data":{},"errcode":"200","errmsg":"","tid":3,"time":1569244680807}A.4.1请求示例POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:77{"cmd":"shutdown","args":{"option":{}},"tid":4,"sid":"","time":1569244816192}CContent-Length:68Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{"data":{},"errcode":"200","errmsg":"","tid":4,"time":1569244680807}A.5重启设备A.5.1请求示例POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:76{"cmd":"restart","args":{"option":{}},"tid":5,"sid":"","time":1569244816192}Content-Length:68Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{"data":{},"errcode":"200","errmsg":"","tid":5,"time":1569244680807}A.6重置设备A.6.1请求示例POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:closeAccept:application/jsonContent-type:application/jsonContent-Length:74{"cmd":"reset","args":{"option":{}},"tid":6,"sid":"","time":1569244816192}Content-Length:68Content-type:application/json;charset=UTF-8Date:Mon,23Sep201912:39:31GMTServer:Apache-Coyote/1.1{"data":{},"errcode":"200","errmsg":"","tid":6,"time":1569244680807}A.7获取设备属性POST/cn.ehiot.simulatorHTTP/1.1Host:Connection:close{"cmd":"get","args":{"property":["version","value"]},"tid":7,"sid":"78d6bff5-ded9-40b0-a3be-998a53a4188a","time":1569245255A.7.2响应示例Content-type:applicatDate:Mon,23Sep2019POST/cn.ehiot.simulatorHTTP/1.1A.8.2响应示例Content-type:applicatDate:Mon,23Sep2019A.9获取帮助POST/cn.ehiot.simulatorHTTP/1.1{"cmd":"help","args":{"name":["version"]},"tid":16,"sid":"d585f6b5-779c-4cOe-b540-3b9le2c0de4e","time":1569245773195}Content-Length:206Content-type:application/json;charset=UTF-8D