GBT383222019信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求

书书书犐犆犛３５．１１０犔７９中华人民共和国国家标准犌犅／犜３８３２２—２０１９信息技术　信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求犐狀犳狅狉犿犪狋犻狅狀狋犲犮犺狀狅犾狅犵狔—犐狀犳狅狉犿犪狋犻狅狀犱犲狏犻犮犲犻狀狋犲狉犮狅狀狀犲犮狋犻狅狀—犐狀狋犲狉犳犪犮犲狉犲狇狌犻狉犲犿犲狀狋狊犫犲狋狑犲犲狀狋犺犻狉犱狆犪狉狋狔狊犿犪狉狋犺狅犿犲犲犾犲犮狋狉犻犮狊狔狊狋犲犿犪狀犱犵犲狀犲狉犪犾狋犲狉犿犻狀犪犾犪犮犮犲狊狊狊犲狉狏犻犮犲狆犾犪狋犳狅狉犿２０１９１２１０发布２０２００７０１实施国家市场监督管理总局国家标准化管理委员会发布书书书目　　次前言Ⅲ…………………………………………………………………………………………………………１　范围１………………………………………………………………………………………………………２　规范性引用文件１…………………………………………………………………………………………３　术语和定义１………………………………………………………………………………………………４　缩略语１……………………………………………………………………………………………………５　通用数据格式１……………………………………………………………………………………………６　消息参数定义３……………………………………………………………………………………………Ⅰ犌犅／犜３８３２２—２０１９前　　言　　本标准按照ＧＢ／Ｔ１．１—２００９给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国信息技术标准化技术委员会（ＳＡＣ／ＴＣ２８）提出并归口。本标准起草单位：阿里巴巴（北京）软件服务有限公司、中国电子技术标准化研究院、小米科技有限责任公司、深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松下家电研究开发（杭州）有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司。本标准主要起草人：安?、刘大鹏、杨宏、郭雄、周珏嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东、邵佩、邓晓平、董征。Ⅲ犌犅／犜３８３２２—２０１９信息技术　信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求１　范围本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义。本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署。２　规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ＧＢ／Ｔ３７７２３—２０１９　信息技术　信息设备互连　智能家用电子系统终端统一接入服务平台总体技术要求３　术语和定义ＧＢ／Ｔ３７７２３—２０１９界定的术语和定义适用于本文件。４　缩略语下列缩略语适用于本文件。ＵＴＣ国际协调时间（ＣｏｏｒｄｉｎａｔｅｄＵｎｉｖｅｒｓａｌＴｉｍｅ）ＵＵＩＤ通用唯一标识符（ＵｎｉｖｅｒｓａｌｌｙＵｎｉｑｕｅＩｄｅｎｔｉｆｉｅｒ）５　通用数据格式５．１　第三方智能家用电子系统请求接口通用数据格式第三方智能家用电子系统请求接口通用数据格式见表１。表１　第三方智能家用电子系统请求接口通用数据格式元素字段名称说明接口名称ｎａｍｅ根据使用的接口分别填写接口类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ服务平台提供给第三方智能家用电子系统的服务接口１犌犅／犜３８３２２—２０１９表１（续）元素字段名称说明请求内容ｓｙｓｔｅｍｒｅｑｕｅｓｔｐａｒａｍｅｔｅｒｓＩＤｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｓｔａｍｐｕｒｌｄｅｖｉｃｅＩＤａｃｃｏｕｎｔｔｏｋｅｎｈｏｓｔｒｓｐＩＤｄｅｖｉｃｅＩＤａｔｔｒｉｂｕｔｅｖａｌｕｅｗｈｉｃｈｕｐｄａｔｅＴｉｍｅｅｘｔｅｎｓｉｏｎａｃｃｏｕｎｔｔｏｋｅｎｄｕｒａｔｉｏｎｄａｔａＩＤ协议版本信息签名值应用客户端密钥的标识值，由制定服务平台统一颁发ＵＴＣ时间戳，自１９７０年１月１日起计算的时间，单位为秒（ｓ）请求源（第三方智能家用电子系统）域名设备标识，第三方智能家用电子系统设备在服务平台的唯一标识，值为平台分配给设备的ＵＵＩＤ用户账号当前用户登录服务平台获取的令牌请求的操作源响应控制类命令时，需将之前下发命令中携带的标识信息作为ｒｓｐ标识值设备标识设置状态值用户数据采集源（设备）的设备标识信息设备状态值更新时间设备状态更新附加信息服务平台的用户账号标识登录服务平台后获得的令牌查询数据的时间范围，ＵＴＣ（ｓ）时间。如果为空，则代表查询最近一次记录的数据数据标识５．２　服务平台请求接口通用数据格式服务平台请求接口通用数据格式见表２。表２　服务平台请求接口通用数据格式元素字段名称说明接口名称ｎａｍｅ根据使用的接口分别填写接口类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ服务平台提供给第三方智能家用电子系统的服务接口请求内容ｉｎｔｅｎｔｄｅｖｉｃｅｓｄｅｖｉｃｅＩＤｓｕｂｓｃｒｉｐｔｉｏｎＩＤ操作描述设备标识订阅标识２犌犅／犜３８３２２—２０１９６　消息参数定义６．１　第三方智能家用电子系统请求接口６．１．１　第三方智能家用电子系统查询终端设备注册信息６．１．１．１　功能描述扩展功能，用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息。６．１．１．２　消息参数定义第三方智能家用电子系统查看终端设备注册信息消息参数定义见表３。表３　第三方智能家用电子系统查看终端设备注册信息消息参数定义元素字段名称必选说明名称ｇｅｔＤｅｖｉｃｅＩｎｆｏ是获取服务平台设备注册信息类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口请求内容ｓｙｓｔｅｍｒｅｑｕｅｓｔｐａｒａｍｅｔｅｒｓｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｓｔａｍｐｕｒｌｐｒｉｖａｃｃｏｕｎｔａｌｉｎｋａｃｃｏｕｎｔｔｏｋｅｎｄｅｖｉｃｅＩＤｇｅｔＤｅｖｉｃｅＩｎｆｏＤａｔａＩＤ是协议版本信息是签名值是请求源，第三方智能家用电子系统的密钥的标识值是时间戳是请求源，第三方智能家用电子系统域名否用户在第三方智能家用电子系统的账号否用户在服务平台的账号否此ｔｏｋｅｎ是ａｌｉｎｋａｃｃｏｕｎｔ账号登录后，服务平台返回给应用客户端的值是设备标识是数据标识６．１．２　第三方智能家用电子系统发送用户设定通知６．１．２．１　功能描述扩展功能，用于第三方智能家用电子系统将用户操作设备的记录通知服务平台。６．１．２．２　消息参数定义第三方智能家用电子系统发送用户设定通知消息参数定义见表４。表４　第三方智能家用电子系统发送用户设定通知消息参数定义元素字段名称必选说明名称ｎｏｔｉｆｙＵｓｅｒＡｃｔｉｏｎ是第三方智能家用电子系统发送用户设定通知类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口３犌犅／犜３８３２２—２０１９表４（续）元素字段名称必选说明请求内容ｓｙｓｔｅｍｒｅｑｕｅｓｔｐａｒａｍｅｔｅｒｓｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｓｔａｍｐｕｒｌａｃｃｏｕｎｔｔｏｋｅｎｈｏｓｔｄｅｖｉｃｅＩＤａｔｔｒｉｂｕｔｅｖａｌｕｅｕｐｄａｔｅＴｉｍｅｅｘｔｅｎｓｉｏｎｎｏｔｉｆｙＵｓｅｒＡｃｔｉｏｎＤａｔａＩＤ是协议版本信息是签名值是请求源，第三方智能家用电子系统的密钥的标识值是时间戳是请求源，第三方智能家用电子系统域名是请求源使用的服务平台账号是登录服务平台后获得的会话令牌是请求操作源是设备标识是设置状态值否设备状态值更新时间否设备状态更新附加信息是数据标识６．１．３　第三方智能家用电子系统验证服务平台用户身份６．１．３．１　功能描述扩展功能，用于第三方智能家用电子系统验证服务平台的用户身份。６．１．３．２　消息参数定义第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表５。表５　第三方智能家用电子系统验证服务平台用户身份消息参数定义元素字段名称必选说明名称ａｕｔｈｅｎｔｉｃａｔｅＡｌｉｎｋＵｓｅｒ是验证服务平台的用户身份类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口请求内容ｓｙｓｔｅｍｒｅｑｕｅｓｔｐａｒａｍｅｔｅｒｓｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｕｒｌａｃｃｏｕｎｔｔｏｋｅｎａｕｔｈｅｎｔｉｃａｔｅＡｌｉｎｋＵｓｅｒＤａｔａＩＤ是协议版本是签名值是请求源，第三方智能家用电子系统的密钥的标识值是时间戳是请求源，第三方智能家用电子系统域名是服务平台的用户账号标识是登录服务平台后获得的会话令牌是数据标识４犌犅／犜３８３２２—２０１９６．１．４　第三方智能家用电子系统用户与服务平台账号绑定６．１．４．１　功能描述扩展功能，用于请求将第三方智能家用电子系统账号与服务平台账号进行绑定。６．１．４．２　消息参数定义第三方智能家用电子系统绑定用户账号的请求消息参数定义见表６。表６　第三方智能家用电子系统绑定用户账号的请求消息参数定义元素字段名称必选说明名称ｂｉｎｄＵｓｅｒＡｃｃｏｕｎｔ是用户第三方智能家用电子系统账号绑定服务平台账号类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口请求内容ｓｙｓｔｅｍｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｒｅｑｕｅｓｔｕｒｌｐａｒａｍｅｔｅｒｓｐｒｉｖａｃｃｏｕｎｔａｌｉｎｋａｃｃｏｕｎｔａｃｃｏｕｎｔｔｏｋｅｎａｃｃｏｕｎｔｔｏｋｅｎｂｉｎｄＵｓｅｒＡｃｃｏｕｎｔＤａｔａＩＤ是是是是是是否是否是协议版本签名值请求源，第三方智能家用电子系统的密钥的标识值时间戳请求源，第三方智能家用电子系统域名第三方智能家用电子系统用户账号标识第三方智能家用电子系统用户登录令牌服务平台用户账号标识服务平台用户登录令牌数据标识６．１．５　第三方智能家用电子系统用户数据上报６．１．５．１　功能描述扩展功能，用于第三方智能家用电子系统请求将用户数据上报至服务平台。６．１．５．２　消息参数定义第三方智能家用电子系统上报用户数据的消息参数定义见表７。表７　第三方智能家用电子系统上报用户数据的消息参数定义元素字段名称必选说明名称ｐｏｓｔＵｓｅｒＤａｔａＡｒｒａｙ是第三方智能家用电子系统上报用户数据类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口５犌犅／犜３８３２２—２０１９表７（续）元素字段名称必选说明请求内容ｓｙｓｔｅｍｖｅｒｓｉｏｎｓｉｇｎｋｅｙｔｉｍｅｒｅｑｕｅｓｔｕｒｌｐａｒａｍｅｔｅｒｓｐｒｉｖａｃｃｏｕｎｔａｌｉｎｋａｃｃｏｕｎｔｔｏｋｅｎａｔｔｒｉｂｕｔｅＳｅｔａｔｔｒｉｂｕｔｅｓｅｔ：｛｝ｗｈｉｃｈｕｐｄａｔｅＴｉｍｅｅｘｔｅｎｓｉｏｎｐｏｓｔＵｓｅｒＤａｔａＡｒｒａｙＤａｔａＩＤ是协议版本是签名值是请求源，第三方智能家用电子系统的密钥的标识值是时间戳是请求源，第三方智能家用电子系统域名否用户在第三方智能家用电子系统的账号否用户在服务平台的账号，需要和令牌字段匹配使用否此令牌是ａｌｉｎｋａｃｃｏｕｎｔ账号登录后，服务平台返回给应用客户端的值，与ａｌｉｎｋａｃｃｏｕｎｔ一起用以校验服务平台用户身份是上传数据名称集合是用户数据集否用户数据采集源（设备）的设备标识信息否用户数据更新时间否用户数据更新附加信息是数据标识６．１．６　第三方智能家用电子系统查询用户数据６．１．６．１　功能描述扩展功能，用于第三方智能家用电子系统请求查询服务平台上的第三方智能家用电子系统的用户数据。６．１．６．２　消息参数定义第三方智能家用电子系统查询用户数据的消息参数定义见表８。表８　第三方智能家用电子系统查询用户数据消息参数定义元素字段名称必选说明名称ｇｅｔＵｓｅｒＤａｔａＡｒｒａｙ是第三方智能家用电子系统上报用户数据类型ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ是服务平台提供给第三方智能家用电子系统的服务接口６犌犅／犜３８３２２—２０１９表８（续）元素字段名称必选说明请求内容ｓｙｓｔｅｍｖｅｒｓｉｏｎｓｉｇｎ