(高清版)GB∕T 38322-2019 信息技术 信息设备互连 第三方智能家用电子系统与终端统一接入服务平台接口要求

L79中华人民共和国国家标准信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求I—Iv—I-v2019-12-10发布2020-07-01实施国家市场监督管理总局国家标准化管理委员会ⅠGB／T38322—2019 1范围 2规范性引用文件 3术语和定义 4缩略语 5通用数据格式 6消息参数定义 ⅢGB／T38322—2019本标准按照GB/T1.1—2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本标准起草单位：阿里巴巴（北京）软件服务有限公司、中国电子技术标准化研究院、小米科技有限责任公司、深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松下家电研究开发（杭州）有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司。本标准主要起草人：安?、刘大鹏、杨宏、郭雄、周珏嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东、邵佩、邓晓平、董征。1GB／T38322—2019信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义。本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T37723—2019信息技术信息设备互连智能家用电子系统终端统一接入服务平台总体技术要求3术语和定义GB/T37723—2019界定的术语和定义适用于本文件。4缩略语下列缩略语适用于本文件。UTC国际协调时间(CoordinatedUniversalTime)5通用数据格式5.1第三方智能家用电子系统请求接口通用数据格式第三方智能家用电子系统请求接口通用数据格式见表1。表1第三方智能家用电子系统请求接口通用数据格式元素字段名称说明接口名称name根据使用的接口分别填写接口类型thirdPartyInterface服务平台提供给第三方智能家用电子系统的服务接口GB／T38322—2019元素字段名称说明请求内容systemversion协议版本信息sign签名值key应用客户端密钥的标识值，由制定服务平台统一颁发timestampUTCs)requesturl请求源（第三方智能家用电子系统）域名deviceID设备标识，第三方智能家用电子系统设备在服务平台的唯一标识，值为平台分配给设备的UUIDaccount用户账号token当前用户登录服务平台获取的令牌host请求的操作源rspID响应控制类命令时，需将之前下发命令中携带的标识信息作parametersdeviceID设备标识attributevalue设置状态值which用户数据采集源（设备）的设备标识信息updateTime设备状态值更新时间extension设备状态更新附加信息account服务平台的用户账号标识token登录服务平台后获得的令牌duration最近一次记录的数据IDdataID数据标识5.2服务平台请求接口通用数据格式服务平台请求接口通用数据格式见表2。表2服务平台请求接口通用数据格式元素字段名称说明接口名称name根据使用的接口分别填写接口类型thirdPartyInterface服务平台提供给第三方智能家用电子系统的服务接口请求内容intent操作描述devicesdeviceID设备标识subscriptionID订阅标识23GB／T38322—20196消息参数定义6.1第三方智能家用电子系统请求接口6.1.1第三方智能家用电子系统查询终端设备注册信息扩展功能，用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息。第三方智能家用电子系统查看终端设备注册信息消息参数定义见表3。表3第三方智能家用电子系统查看终端设备注册信息消息参数定义元素字段名称必选说明名称getDeviceInfo是获取服务平台设备注册信息类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口请求内容systemversion是协议版本信息sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值timestamp是时间戳requesturl是请求源，第三方智能家用电子系统域名priv-account否用户在第三方智能家用电子系统的账号alink-account否用户在服务平台的账号token否此token是alink-account账号登录后，服务平台返回给应用客户端的值parametersdeviceID是设备标识getDeviceInfoDataID是数据标识6.1.2第三方智能家用电子系统发送用户设定通知扩展功能，用于第三方智能家用电子系统将用户操作设备的记录通知服务平台。第三方智能家用电子系统发送用户设定通知消息参数定义见表4。表4第三方智能家用电子系统发送用户设定通知消息参数定义元素字段名称必选说明名称是第三方智能家用电子系统发送用户设定通知类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口4GB／T38322—2019元素字段名称必选说明请求内容systemversion是协议版本信息sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值timestamp是时间戳requesturl是请求源，第三方智能家用电子系统域名account是请求源使用的服务平台账号token是登录服务平台后获得的会话令牌host是请求操作源parametersdeviceID是设备标识attributevalue是设置状态值updateTime否设备状态值更新时间extension否设备状态更新附加信息是数据标识6.1.3第三方智能家用电子系统验证服务平台用户身份扩展功能，用于第三方智能家用电子系统验证服务平台的用户身份。第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表5。表5第三方智能家用电子系统验证服务平台用户身份消息参数定义元素字段名称必选说明名称authenticateAlinkUser是验证服务平台的用户身份类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口请求内容systemversion是协议版本sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值time是时间戳requesturl是请求源，第三方智能家用电子系统域名parametersaccount是服务平台的用户账号标识token是登录服务平台后获得的会话令牌authenticateAlinkUserDataID是数据标识5GB／T38322—20196.1.4第三方智能家用电子系统用户与服务平台账号绑定扩展功能，用于请求将第三方智能家用电子系统账号与服务平台账号进行绑定。第三方智能家用电子系统绑定用户账号的请求消息参数定义见表6。表6第三方智能家用电子系统绑定用户账号的请求消息参数定义元素字段名称必选说明名称bindUserAccount是用户第三方智能家用电子系统账号绑定服务平台账号类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口请求内容systemversion是协议版本sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值time是时间戳requesturl是请求源，第三方智能家用电子系统域名parameterspriv-accountaccount是第三方智能家用电子系统用户账号标识token否第三方智能家用电子系统用户登录令牌alink-accountaccount是服务平台用户账号标识token否服务平台用户登录令牌bindUserAccountDataID是数据标识6.1.5第三方智能家用电子系统用户数据上报扩展功能，用于第三方智能家用电子系统请求将用户数据上报至服务平台。第三方智能家用电子系统上报用户数据的消息参数定义见表7。表7第三方智能家用电子系统上报用户数据的消息参数定义元素字段名称必选说明名称是第三方智能家用电子系统上报用户数据类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口GB／T38322—2019元素字段名称必选说明请求内容systemversion是协议版本sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值time是时间戳requesturl是请求源，第三方智能家用电子系统域名parameterspriv-account否用户在第三方智能家用电子系统的账号alink-account否用户在服务平台的账号，需要和令牌字段匹配使用token否此令牌是alink-account账号登录后，服务平台返校验服务平台用户身份attributeSet是上传数据名称集合attributeset:{}是用户数据集which否用户数据采集源（设备）的设备标识信息updateTime否用户数据更新时间extension否用户数据更新附加信息是数据标识6.1.6第三方智能家用电子系统查询用户数据扩展功能，用于第三方智能家用电子系统请求查询服务平台上的第三方智能家用电子系统的用户数据。第三方智能家用电子系统查询用户数据的消息参数定义见表8。表8第三方智能家用电子系统查询用户数据消息参数定义元素字段名称必选说明名称是第三方智能家用电子系统上报用户数据类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口67GB／T38322—2019元素字段名称必选说明请求内容systemversion是协议版本sign是签名值key是请求源，第三方智能家用电子系统的密钥的标识值time是时间戳requesturl是请求源，第三方智能家用电子系统域名parameterspriv-account否用户在第三方智能家用电子系统的账号attributeSet是用户待查询数据名称集合duration否则代表查询最近一次记录的数据是数据标识6.2服务平台请求接口6.2.1服务平台获取第三方智能家用电子系统终端设备列表扩展功能，用于服务平台获取第三方智能家用电子系统的终端设备列表。服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义见表9。表9服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义元素字段名称必选说明名称getDeviceList是获取第三方智能家用电子系统的设备列表类型thirdPartyInterface是服务平台提供给第三方智能家用电子系统的服务接口请求内容intent是请求获取设备信息列表getDeviceListDataID是数据标识6.2.2服务平台向第三方智能家用电子系统订阅事件扩展功能，用于服务平台请求第三方智能家用电子系统进行终端设备的事件订阅。服务平台向