GB/T 38322-2019

110 犔79 中华人民共和国国家标准犌犅/犜38322—2019 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求犐狀犳狅狉犿犪狋犻狅狀狋犲犮犺狀狅犾狅犵狔—犐狀犳狅狉犿犪狋犻狅狀犱犲狏犻犮犲犻狀狋犲狉犮狅狀狀犲犮狋犻狅狀— 犐狀狋犲狉犳犪犮犲狉犲狇狌犻狉犲犿犲狀狋狊犫犲狋狑犲犲狀狋犺犻狉犱-狆犪狉狋狔狊犿犪狉狋犺狅犿犲犲犾犲犮狋狉犻犮狊狔狊狋犲犿犪狀犱犵犲狀犲狉犪犾狋犲狉犿犻狀犪犾犪犮犮犲狊狊狊犲狉狏犻犮犲狆犾犪狋犳狅狉犿 2019-12-10发布 2020-07-01实施国家市场监督管理总局国家标准化管理委员会发布目次前言 III ........................................................................................................................ 1 范围 1 ..................................................................................................................... 2 规范性引用文件 1 ...................................................................................................... 3 术语和定义 1 ............................................................................................................ 4 缩略语 1 .................................................................................................................. 5 通用数据格式 1 ......................................................................................................... 6 消息参数定义 3 ......................................................................................................... I 犌犅/犜38322—2019 前言本标准按照GB/T1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。 本标准起草单位:阿里巴巴(北京)软件服务有限公司、中国电子技术标准化研究院、小米科技有限责任公司、深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松下家电研究开发(杭州)有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司。 本标准主要起草人:安?、刘大鹏、杨宏、郭雄、周珏嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、 宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东、邵佩、邓晓平、董征。 III 犌犅/犜38322—2019 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求 1 范围本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义。 本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署。 2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T37723—2019 信息技术信息设备互连智能家用电子系统终端统一接入服务平台总体技术要求 3 术语和定义 GB/T37723—2019界定的术语和定义适用于本文件。 4 缩略语下列缩略语适用于本文件。 UTC国际协调时间(CoordinatedUniversalTime) UUID通用唯一标识符(UniversallyUniqueIdentifier) 5 通用数据格式 5.1 第三方智能家用电子系统请求接口通用数据格式第三方智能家用电子系统请求接口通用数据格式见表1。 表1 第三方智能家用电子系统请求接口通用数据格式元素字段名称说明接口名称 name 根据使用的接口分别填写接口类型 thirdPartyInterface 服务平台提供给第三方智能家用电子系统的服务接口 1 犌犅/犜38322—2019 表1(续) 元素字段名称说明请求内容 system request parameters ID version sign key timestamp url deviceID account token host rspID deviceID attribute value which updateTime extension account token duration dataID 协议版本信息签名值应用客户端密钥的标识值,由制定服务平台统一颁发 UTC时间戳,自1970年1月1日起计算的时间,单位为秒(s) 请求源(第三方智能家用电子系统)域名设备标识,第三方智能家用电子系统设备在服务平台的唯一标识,值为平台分配给设备的UUID 用户账号当前用户登录服务平台获取的令牌请求的操作源响应控制类命令时,需将之前下发命令中携带的标识信息作为rsp标识值设备标识设置状态值用户数据采集源(设备)的设备标识信息设备状态值更新时间设备状态更新附加信息服务平台的用户账号标识登录服务平台后获得的令牌查询数据的时间范围,UTC(s)时间。如果为空,则代表查询最近一次记录的数据数据标识 5.2 服务平台请求接口通用数据格式服务平台请求接口通用数据格式见表2。 表2 服务平台请求接口通用数据格式元素字段名称说明接口名称 name 根据使用的接口分别填写接口类型 thirdPartyInterface 服务平台提供给第三方智能家用电子系统的服务接口请求内容 intent devices deviceID subscriptionID 操作描述设备标识订阅标识 2 犌犅/犜38322—2019 6 消息参数定义 6.1 第三方智能家用电子系统请求接口 6.1.1 第三方智能家用电子系统查询终端设备注册信息 6.1.1.1 功能描述扩展功能,用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息。 6.1.1.2 消息参数定义第三方智能家用电子系统查看终端设备注册信息消息参数定义见表3。 表3 第三方智能家用电子系统查看终端设备注册信息消息参数定义元素字段名称必选说明名称 getDeviceInfo 是获取服务平台设备注册信息类型 thirdPartyInterface 是服务平台提供给第三方智能家用电子系统的服务接口请求内容 system request parameters version sign key timestamp url priv-account alink-account token deviceID getDeviceInfoDataID 是协议版本信息是签名值是请求源,第三方智能家用电子系统的密钥的标识值是时间戳是请求源,第三方智能家用电子系统域名否用户在第三方智能家用电子系统的账号否用户在服务平台的账号否此token是alink-account账号登录后,服务平台返回给应用客户端的值是设备标识是数据标识 6.1.2 第三方智能家用电子系统发送用户设定通知 6.1.2.1 功能描述扩展功能,用于第三方智能家用电子系统将用户操作设备的记录通知服务平台。 6.1.2.2 消息参数定义第三方智能家用电子系统发送用户设定通知消息参数定义见表4。 表4 第三方智能家用电子系统发送用户设定通知消息参数定义元素字段名称必选说明名称 notifyUserAction 是第三方智能家用电子系统发送用户设定通知类型 thirdPartyInterface 是服务平台提供给第三方智能家用电子系统的服务接口 3 犌犅/犜38322—2019 表4(续) 元素字段名称必选说明请求内容 system request parameters version sign key timestamp url account token host deviceID attribute value updateTime extension notifyUserActionDataID 是协议版本信息是签名值是请求源,第三方智能家用电子系统的密钥的标识值是时间戳是请求源,第三方智能家用电子系统域名是请求源使用的服务平台账号是登录服务平台后获得的会话令牌是请求操作源是设备标识是设置状态值否设备状态值更新时间否设备状态更新附加信息是数据标识 6.1.3 第三方智能家用电子系统验证服务平台用户身份 6.1.3.1 功能描述扩展功能,用于第三方智能家用电子系统验证服务平台的用户身份。 6.1.3.2 消息参数定义第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表5。 表5 第三方智能家用电子系统验证服务平台用户身份消息参数定义元素字段名称必选说明名称 authenticateAlinkUser 是验证服务平台的用户身份类型 thirdPartyInterface 是服务平台提供给第三方智能家用电子系统的服务接口请求内容 system request parameters version sign key time url account token authenticateAlinkUserDataID 是协议版本是签名值是请求源,第三方智能家用电子系统的密钥的标识值是时间戳是请求源,第三方智能家用电子系统域名是服务平台的用户账号标识是登录服务平台后获得的会话令牌是数据标识 4 犌犅/犜38322—2019 6.1.4 第三方智能家用电子系统用户与服务平台账号绑定 6.1.4.1 功能描述扩展功能,用于请求将第三方智能家用电子系统账号与服务平台账号进行绑定。 6.1.4.2 消息参数定义第三方智能家用电子系统绑定用户账号的请求消息参数定义见表6。 表6 第三方智能家用电子系统绑定用户账号的请求消息参数定义元素字段名称必选说明名称 bindUserAccount 是用户第三方智能家用电子系统账号绑定服务平台账号类型 thirdPartyInterface 是服务平台提供给第三方智能家用电子系统的服务接口请求内容 system version sign key time request url parameters priv-account alink-account account token account token bindUserAccountDataID 是是是是是是否是否是协议版本签名值请求源,第三方智能家用电子系统的密钥的标识值时间戳请求源,第三方智能家用电子系统域名第三方智能家用电子系统用户账号标识第三方智能家用电子系统用户登录令牌服务平台用户账号标识服务平台用户登录令牌数据标识 6.1.5 第三方智能家用电子系统用户数据上报 6.1.5.1 功能描述扩展功能,用于第三方智能家用电子系统请求将用户数据上报至服务平台。 6.1.5.2 消息参数定义第三方智能家用电子系统上报用户数据的消息参数定义见表7。 表7 第三方智能家用电子系统上报用户数据的消息参数定义元素字段名称必选说明名称 postUserDataArray 是第三方智能家用电子系统上报用户数据类型 thirdPartyInterface 是服务