标准搜索结果: 'GB/T 38322-2019'
| 标准编号 | GB/T 38322-2019 (GB/T38322-2019) | | 中文名称 | 信息技术 信息设备互连 第三方智能家用电子系统与终端统一接入服务平台接口要求 | | 英文名称 | Information technology - Information device interconnection - Interface requirements between third-party smart home electric system and general terminal access service platform | | 行业 | 国家标准 (推荐) | | 中标分类 | L79 | | 国际标准分类 | 35.110 | | 字数估计 | 14,126 | | 发布日期 | 2019-12-10 | | 实施日期 | 2020-07-01 | | 发布机构 | 国家市场监督管理总局、中国国家标准化管理委员会 | GB/T 38322-2019
Information technology--Information device interconnection--Interface requirements between third-party smart home electric system and general terminal access service platform
ICS 35.110
L79
中华人民共和国国家标准
信息技术 信息设备互连
第三方智能家用电子系统与
终端统一接入服务平台接口要求
2019-12-10发布
2020-07-01实施
国 家 市 场 监 督 管 理 总 局
国 家 标 准 化 管 理 委 员 会 发 布
目次
前言 Ⅲ
1 范围 1
2 规范性引用文件 1
3 术语和定义 1
4 缩略语 1
5 通用数据格式 1
6 消息参数定义 3
前言
本标准按照GB/T 1.1-2009给出的规则起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。
本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。
本标准起草单位:阿里巴巴(北京)软件服务有限公司、中国电子技术标准化研究院、小米科技有限
责任公司、深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松
下家电研究开发(杭州)有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司。
本标准主要起草人:安勍、刘大鹏、杨宏、郭雄、周珏嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、
宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东、邵佩、邓晓平、董征。
信息技术 信息设备互连
第三方智能家用电子系统与
终端统一接入服务平台接口要求
1 范围
本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义。
本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文
件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 37723-2019 信息技术 信息设备互连 智能家用电子系统终端统一接入服务平台总体
技术要求
3 术语和定义
GB/T 37723-2019界定的术语和定义适用于本文件。
4 缩略语
下列缩略语适用于本文件。
5 通用数据格式
5.1 第三方智能家用电子系统请求接口通用数据格式
第三方智能家用电子系统请求接口通用数据格式见表1。
表1 第三方智能家用电子系统请求接口通用数据格式
元素 字段名称 说明
接口名称 name 根据使用的接口分别填写
接口类型 thirdPartyInterface 服务平台提供给第三方智能家用电子系统的服务接口
表1(续)
元素 字段名称 说明
请求内容
system
request
ID
version
sign
key
url
deviceID
account
token
rspID
deviceID
attribute
which
updateTime
account
token
duration
协议版本信息
签名值
应用客户端密钥的标识值,由制定服务平台统一颁发
UTC时间戳,自1970年1月1日起计算的时间,单位为秒(s)
请求源(第三方智能家用电子系统)域名
设备标识,第三方智能家用电子系统设备在服务平台的唯一
标识,值为平台分配给设备的UUID
用户账号
当前用户登录服务平台获取的令牌
请求的操作源
响应控制类命令时,需将之前下发命令中携带的标识信息作
为rsp标识值
设备标识
设置状态值
用户数据采集源(设备)的设备标识信息
设备状态值更新时间
设备状态更新附加信息
服务平台的用户账号标识
登录服务平台后获得的令牌
查询数据的时间范围,UTC(s)时间。如果为空,则代表查询
最近一次记录的数据
数据标识
5.2 服务平台请求接口通用数据格式
服务平台请求接口通用数据格式见表2。
表2 服务平台请求接口通用数据格式
元素 字段名称 说明
接口名称 name 根据使用的接口分别填写
接口类型 thirdPartyInterface 服务平台提供给第三方智能家用电子系统的服务接口
请求内容
intent
devices
deviceID
操作描述
设备标识
订阅标识
6 消息参数定义
6.1 第三方智能家用电子系统请求接口
6.1.1 第三方智能家用电子系统查询终端设备注册信息
6.1.1.1 功能描述
扩展功能,用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息。
6.1.1.2 消息参数定义
第三方智能家用电子系统查看终端设备注册信息消息参数定义见表3。
表3 第三方智能家用电子系统查看终端设备注册信息消息参数定义
元素 字段名称 必选 说明
名称 getDeviceInfo 是 获取服务平台设备注册信息
类型 thirdPartyInterface 是 服务平台提供给第三方智能家用电子系统的服务接口
请求内容
system
request
version
sign
key
timestamp
priv-account
alink-account
token
deviceID
是 协议版本信息
是 签名值
是 请求源,第三方智能家用电子系统的密钥的标识值
是 时间戳
是 请求源,第三方智能家用电子系统域名
否 用户在第三方智能家用电子系统的账号
否 用户在服务平台的账号
此token是alink-account账号登录后,服务平台返回给
应用客户端的值
是 设备标识
是 数据标识
6.1.2 第三方智能家用电子系统发送用户设定通知
6.1.2.1 功能描述
扩展功能,用于第三方智能家用电子系统将用户操作设备的记录通知服务平台。
6.1.2.2 消息参数定义
第三方智能家用电子系统发送用户设定通知消息参数定义见表4。
表4 第三方智能家用电子系统发送用户设定通知消息参数定义
元素 字段名称 必选 说明
名称 notifyUserAction 是 第三方智能家用电子系统发送用户设定通知
类型 thirdPartyInterface 是 服务平台提供给第三方智能家用电子系统的服务接口
表4(续)
元素 字段名称 必选 说明
请求内容
system
request
version
sign
key
timestamp
account
token
host
attribute
value
extension
是 协议版本信息
是 签名值
是 请求源,第三方智能家用电子系统的密钥的标识值
是 时间戳
是 请求源,第三方智能家用电子系统域名
是 请求源使用的服务平台账号
是 登录服务平台后获得的会话令牌
是 请求操作源
是 设备标识
是 设置状态值
否 设备状态值更新时间
否 设备状态更新附加信息
是 数据标识
6.1.3 第三方智能家用电子系统验证服务平台用户身份
6.1.3.1 功能描述
扩展功能,用于第三方智能家用电子系统验证服务平台的用户身份。
6.1.3.2 消息参数定义
第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表5。
表5 第三方智能家用电子系统验证服务平台用户身份消息参数定义
元素 字段名称 必选 说明
类型 thirdPartyInterface 是 服务平台提供给第三方智能家用电子系统的服务接口
请求内容
system
request
version
sign
key
time
url
token
是 协议版本
是 签名值
是 请求源,第三方智能家用电子系统的密钥的标识值
是 时间戳
是 请求源,第三方智能家用电子系统域名
是 服务平台的用户账号标识
是 登录服务平台后获得的会话令牌
是 数据标识
6.1.4 第三方智能家用电子系统用户与服务平台账号绑定
6.1.4.1 功能描述
扩展功能,用于请求将第三方智能家用电子系统账号与服务平台账号进行绑定。
6.1.4.2 消息参数定义
第三方智能家用电子系统绑定用户账号的请求消息参数定义见表6。
表6 第三方智能家用电子系统绑定用户账号的请求消息参数定义
元素 字段名称 必选 说明
名称 bindUserAccount 是
用户第三方智能家用电子系统账号绑定服务平
台账号
类型 thirdPartyInterface 是
服务平台提供给第三方智能家用电子系统的服
务接口
请求内容
system
version
sign
key
time
parameters
priv-account
alink-account
account
token
token
协议版本
签名值
请求源,第三方智能家用电子系统的密钥的标
识值
时间戳
请求源,第三方智能家用电子系统域名
第三方智能家用电子系统用户账号标识
第三方智能家用电子系统用户登录令牌
服务平台用户账号标识
服务平台用户登录令牌
数据标识
6.1.5 第三方智能家用电子系统用户数据上报
6.1.5.1 功能描述
扩展功能,用于第三方智能家用电子系统请求将用户数据上报至服务平台。
6.1.5.2 消息参数定义
第三方智能家用电子系统上报用户数据的消息参数定义见表7。
表7 第三方智能家用电子系统上报用户数据的消息参数定义
元素 字段名称 必选 说明
名称 postUserDataArray 是 第三方智能家用电子系统上报用户数据
类型 thirdPartyInterface 是 服务平台提供给第三方智能家用电子系统的服务接口
表7(续)
元素 字段名称 必选 说明
请求内容
system
version
sign
key
time
parameters
priv-account
alink-account
token
attribute
set:{}
which
updateTime
是 协议版本
是 签名值
请求源,第三方智能家用电子系统的密钥的标
识值
是 时间戳
是 请求源,第三方智能家用电子系统域名
否 用户在第三方智能家用电子系统的账号
用户在服务平台的账号,需要和令牌字段匹配
使用
此令牌是alink-account账号登录后,服务平台返
回给应用客户端的值,与alink-account一起用以
校验服务平台用户身份
是 上传数据名称集合
是 用户数据集
否 用户数据采集源(设备)的设备标识信息
否 用户数据更新时间
否 用户数据更新附加信息
是 数据标识
6.1.6 第三方智能家用电子系统查询用户数据
6.1.6.1 功能描述
扩展功能,用于第三方智能家用电子系统请求查询服务平台上的第三方智能家用电子系统的用户
数据。
6.1.6.2 消息参数定义
第三方智能家用电子系统查询用户数据的消息参数定义见表8。
表8 第三方智能家用电子系统查询用户数据消息参数定义
元素 字段名称 必选 说明
名称 getUserDataArray 是 第三方智能家用电子系统上报用户数据
类型 thirdPartyInterface 是
服务平台提供给第三方智能家用电子系统的服
务接口
表8(续)
元素 字段名称 必选 说明
请求内容
system
version
sign
key
time
parameters
priv-account
attributeSet
是 协议版本
是 签名值
是 请求源,第三方智能家用电子系统的密钥的标识值
是 时间戳
是 请求源,第三方智能家用电子系统域名
否 用户在第三方智能家用电子系统的账号
是 用户待查询数据名称集合
查询数据的时间范围,UTC(s)时间。如果为空,
则代表查询最近一次记录的数据
是 数据标识
6.2 服务平台请求接口
6.2.1 服务平台获取第三方智能家用电子系统终端设备列表
6.2.1.1 功能描述
扩展功能,用于服务平台获取第三方智能家用电子系统的终端设备列表。
6.2.1.2 消息参数定义
服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义见表9。
表9 服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义
元素 字段名称 必选 说明
名称 getDeviceList 是 获取第三方智能家用电子系统的设备列表
类型 thirdPartyInte......
|