GB/T38322-2019
信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求
Informationtechnology—Informationdeviceinterconnection—Interfacerequirementsbetweenthird-partysmarthomeelectricsystemandgeneralterminalaccessserviceplatform
- 中国标准分类号（CCS）L79
- 国际标准分类号（ICS）35.110
- 实施日期2020-07-01
- 文件格式PDF
- 文本页数11页
- 文件大小575.44KB
以图片形式预览信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求
信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求
国家标准 GB/T38322一2019 信息技术信息设备互连 第三方智能家用电子系统与 终端统一接入服务平台接口要求 Infomationtechnology一Informationdeviceintereonnection一 Interfacereguirementsbetweenthirdpartysmarthomeelectricsystemand generalterminalaccessservieeplatform 2019-12-10发布 2020-07-01实施 国家市场监督管理总局 发布 国家标涯花警理委员会国家标准
GB/38322一2019 目 次 前言 范围 2 规范性引用文件 术语和定义 缩略语 通用数据格式 消息参数定义
GB/38322一2019 前 言 本标准按照GB/T1.1一2009给出的规则起草
请注意本文件的某些内容可能涉及专利
本文件的发布机构不承担识别这些专利的责任
本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口
本标准起草单位:阿里巴巴(北京)软件服务有限公司、电子技术标准化研究院、小米科技有限 责任公司深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松 下家电研究开发(杭州)有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司
本标准主要起草人:安就、刘大鹏、杨宏、郭雄、周压嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、 宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东将邵佩、邓晓平、董征
GB/38322一2019 信息技术信息设备互连 第三方智能家用电子系统与 终端统一接入服务平台接口要求 范围 本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义
本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
GB/T377232019信息技术信息设备互连智能家用电子系统终端统一接人服务平台总体 技术要求 术语和定义 GB/T37723一2019界定的术语和定义适用于本文件
缩略语 下列缩略语适用于本文件
UTc国际协调时间(CoordinatedUniversalTime) UUD通用唯一标识符(UniversallyUniqueldentifer) 通用数据格式 5 5.1第三方智能家用电子系统请求接口通用数据格式 第三方智能家用电子系统请求接口通用数据格式见表1
表1第三方智能家用电子系统请求接口通用数据格式 元素 字段名称 说明 接口名称 根据使用的接口分别填写 namme 接口类型 thirdPartylnterface 服务平台提供给第三方智能家用电子系统的服务接口
GB/T38322一2019 表1续 元素 字段名称 说明 versiom 协议版本信息 签名值 sign system 应用客户端密钥的标识值,由制定服务平台统一颁发 key UTC时间戳，自1970年1月1日起计算的时间,单位为秒(s) timestamp 请求源(第三方智能家用电子系统)域名 url 设备标识,第三方智能家用电子系统设备在服务平台的唯一 deicelD 标识,值为平台分配给设备的UUID 用户账号 account reguest 当前用户登录服务平台获取的令牌 token 请求的操作源 host 响应控制类命令时,需将之前下发命令中携带的标识信息作 请求内容 rspID 为rsp标识值 devicelID 设备标识 设置状态值 Value which 用户数据采集源(设备)的设备标识信息 attiute updateTime设备状态值更新时间 parameters extension 设备状态更新附加信息 服务平台的用户账号标识 account 登录服务平台后获得的令牌 token 查询数据的时间范围,UTc(s)时间
如果为空,则代表查询 duration 最近一次记录的数据 dataID 数据标识 D 5.2服务平台请求接口通用数据格式 服务平台请求接口通用数据格式见表2. 表2服务平台请求接口通用数据格式 元素 字段名称 说明 接口名称 根据使用的接口分别填写 name thirdPartylnterface 接口类型 服务平台提供给第三方智能家用电子系统的服务接口 操作描述 intent 请求内容 devicelD 设备标识 devices subscriptionlD 订阅标识
GB/38322一2019 消息参数定义 6.1第三方智能家用电子系统请求接口 6.1.1第三方智能家用电子系统查询终端设备注册信息 6.1.1.1功能描述 扩展功能,用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息
6.1.1.2消息参数定义 第三方智能家用电子系统查看终端设备注册信息消息参数定义见表3
表3第三方智能家用电子系统查看终端设备注册信息消息参数定义 元素 字段名称 必选 说明 名称 getDevicelnfo 是 获取服务平台设备注册信息 类型 thirdPartylnterface 是 服务平台提供给第三方智能家用电子系统的服务接口 version 协议版本信息 签名值 sign System key 是 请求源,第三方智能家用电子系统的密钥的标识值 是 时间戳 timestamp 是 请求源,第三方智能家用电子系统域名 ur 请求内容 否 用户在第三方智能家用电子系统的账号 priv-account reguest alink-account 否 用户在服务平台的账号 此token是alnkacount账号登录后,服务平台返回给 否 token 应用客户端的值 dewiceID 是 设备标识 parameters 数据标识 getDevieelnfoDatalD 6.1.2第三方智能家用电子系统发送用户设定通知 6.1.2.1功能描述 扩展功能,用于第三方智能家用电子系统将用户操作设备的记录通知服务平台
6.1.2.2消息参数定义 第三方智能家用电子系统发送用户设定通知消息参数定义见表4
表4第三方智能家用电子系统发送用户设定通知消息参数定义 字段名称 元素 必选 说明 名称 notifyUserAction 是 第三方智能家用电子系统发送用户设定通知 服务平台提供给第三方智能家用电子系统的服务接口 类型 thirdPartylnterface 是
GB/T38322一2019 表4续 元素 字段名称 必选 说明 协议版本信息 version 是 是 签名值 ign system 是 请求源,第三方智能家用电子系统的密钥的标识值 key 时间戳 是 timestamp 是 请求源,第三方智能家用电子系统域名 url 是 请求源使用的服务平台账号 account reguest 登录服务平台后获得的会话令牌 是 请求内容 token 是 请求操作源 host devieeID 是 设备标识 设置状态值 value 是 parameters 否 attributelupxdateTie 设备状态值更新时间 否 设备状态更新附加信息 extension notifyUserActionDatalD 是 数据标识 6.1.3第三方智能家用电子系统验证服务平台用户身份 6.1.3.1功能描述 扩展功能用于第三方智能家用电子系统验证服务平台的用户身份
6.1.3.2消息参数定义 第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表5
表5第三方智能家用电子系统验证服务平台用户身份消息参数定义 元素 字段名称 必选 说明 authentieateAlinkUser 名称 是 验证服务平台的用户身份 类型 是 服务平台提供给第三方智能家用电子系统的服务接口 thirdPartyInterface version 是 协议版本 签名值 是 sign system 请求源,第三方智能家用电子系统的密钥的标识值 key 是 时间戳 time 请求内容 ur 是 请求源,第三方智能家用电子系统域名 reguest accont 是 服务平台的用户账号标识 parameters 登录服务平台后获得的会话令牌 token 是 数据标识 authenticateAIinkUserDatalD 是
GB/38322一2019 6.1.4第三方智能家用电子系统用户与服务平台账号绑定 6.1.4.1 功能描述 扩展功能,用于请求将第三方智能家用电子系统账号与服务平台账号进行绑定
6.1.4.2消息参数定义 第三方智能家用电子系统绑定用户账号的请求消息参数定义见表6
表6第三方智能家用电子系统绑定用户账号的请求消息参数定义 元素 字段名称 必选 说明 用户第三方智能家用电子系统账号绑定服务平 是 名称 bindUserAccount 台账号 服务平台提供给第三方智能家用电子系统的服 类型 是 thirdPartylnterface 务接口 是 version 协议版本 签名值 是 sign system 请求源,第三方智能家用电子系统的密钥的标 key 识值 时间戳 tinme 是 是 请求源,第三方智能家用电子系统域名 reguest url 请求内容 是 第三方智能家用电子系统用户账号标识 accounmt privaccount 否 第三方智能家用电子系统用户登录令牌 token parameter 是 服务平台用户账号标识 account alink-accoun 否 token 服务平台用户登录令牌 bindUserAccountDatalID 是 数据标识 6.1.5第三方智能家用电子系统用户数据上报 6.1.5.1功能描述 扩展功能,用于第三方智能家用电子系统请求将用户数据上报至服务平台
6.1.5.2消息参数定义 第三方智能家用电子系统上报用户数据的消息参数定义见表7
表7第三方智能家用电子系统上报用户数据的消息参数定义 元素 字段名称 必选 说明 第三方智能家用电子系统上报用户数据 postUserDataArray 是 名称 类型 服务平台提供给第三方智能家用电子系统的服务接口 hPfe 是
GB/T38322一2019 表7(续 元素 字段名称 必选 说明 协议版本 versiom 是 签名值 是 sign system 请求源,第三方智能家用电子系统的密钥的标 key 是 识值 time 是 时间戳 是 url 请求源,第三方智能家用电子系统域名 reguest 用户在第三方智能家用电子系统的账号 否 priv-aceount 用户在服务平台的账号,需要和令牌字段匹配 alink-account 否 使用 请求内容 此令牌是alink-account账号登录后,服务平台返 回给应用客户端的值,与alinkaeccount一起用以 token 否 校验服务平台用户身份 parameters 上传数据名称集 attributeSet 是 是 用户数据集 set: which 否 用户数据采集源(设备)的设备标识信息 attiute updateTime 否 用户数据更新时间 否 extension 用户数据更新附加信息 是 postUserDataArrayDatalD 数据标识 6.1.6第三方智能家用电子系统查询用户数据 6.1.6.1功能描述 扩展功能,用于第三方智能家用电子系统请求查询服务平台上的第三方智能家用电子系统的用户 数据
6.1.6.2消息参数定义 第三方智能家用电子系统查询用户数据的消息参数定义见表8
表8第三方智能家用电子系统查询用户数据消息参数定义 元素 字段名称 必选 说明 第三方智能家用电子系统上报用户数据 名称 getUserDataArray 是 服务平台提供给第三方智能家用电子系统的服 是 类型 thirdPartylnterface 务接口
GB/38322一2019 表8(续 元素 字段名称 必选 说明 协议版本 version 是 签名值 sign system 请求源,第三方智能家用电子系统的密钥的标识值 key 时间戳 time url 是 请求源,第三方智能家用电子系统域名 reguest 请求内容 否 用户在第三方智能家用电子系统的账号 priV-account 是 attributeSet 用户待查询数据名称集合 paraeters 查询数据的时间范围,Uc(s)时间
如果为空， 否 duration 则代表查询最近一次记录的数据 数据标识 是 etUserDataArrayDatalD 6.2服务平台请求接口 6.2.1服务平台获取第三方智能家用电子系统终端设备列表 6.2.1.1功能描述 扩展功能,用于服务平台获取第三方智能家用电子系统的终端设备列表
6.2.1.2消息参数定义 服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义见表9
表9服务平台向第三方智能家用电子系统发起获取终端设备列表请求消息参数定义 字段名称 说明 元素 必选 名称 是 获取第三方智能家用电子系统的设备列表 getDeviceList 服务平台提供给第三方智能家用电子系统 thirdlPartylnterface 类型 是 的服务接口 是 请求获取设备信息列表 intent 请求内容 是 getDevieceListDatalD 数据标识 6.2.2服务平台向第三方智能家用电子系统订阅事件 6.2.2.1 功能描述 扩展功能,用于服务平台请求第三方智能家用电子系统进行终端设备的事伴订阅 6.2.2.2消息参数定义 服务平台向第三方智能家用电子系统发起订阅请求消息参数定义见表10
GB/T38322一2019 表10服务平台向第三方智能家用电子系统发起订阅请求消息参数定义 元素 字段名称 必选 说明 订阅第三方智能家用电子系统的设备事件 名称 subscribeDevieeEvent 是 服务平台提供给第三方智能家用电子系统的服 类型 thirdPartylnterface 是 务接口 是 请求发起订阅事件 intent deviceeID 是 设备标识 请求内容 devices 是 subscriptionlD 订阅标识 是 subscribeDevieeEventDatalD 数据标识
信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求GB/T38322-2019
在智能家居领域，各种智能设备及系统逐渐融入人们的生活。然而，由于各种设备和系统来自不同的制造商，它们之间存在着差异，因此需要一个统一的接口标准来实现各种设备和系统之间的互联。
GB/T38322-2019《信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求》就是为了解决这个问题而制定的标准。该标准规定了第三方智能家用电子系统及其终端设备统一接入服务平台所需遵循的接口要求。
该标准主要作用是规范智能家居设备之间的通信方式，提高各种设备之间的兼容性和互联互通性，实现不同品牌、不同技术的智能家居设备的统一控制和管理。同时，它也为智能家居企业提供了技术基础和标准保障，有助于推进智能家居市场的发展。
在应用方面，GB/T38322-2019标准适用于所有第三方智能家用电子系统及其终端设备与服务平台的接入。这些系统和设备包括但不限于：智能灯具、智能插座、智能门锁、智能窗帘、智能电视等。
总之，GB/T38322-2019标准对于智能家居行业的发展至关重要。它不仅为用户提供了更好的体验，也为企业提供了更多的商机和发展空间。
信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求的相关资料
- 反垃圾信息技术要求GB/T26265-2010
- 信息技术软件资产管理：GB/T26236.1-2010
- GB/T26228.1-2010信息技术自动识别与数据采集技术条码检测仪一致性规范第1部分：一维条码
- GB/T26227-2010信息技术自动识别与数据采集技术条码原版胶片测试规范
- 信息技术开放系统互连一致性测试方法和框架第6部分：协议轮廓测试规范GB/T17178.6-2010
- 信息技术信息设备互连智能家用电子系统终端统一接入服务平台总体技术要求GB/T37723-2019
- 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求GB/T38322-2019
- 信息技术信息设备互连智能家用电子系统终端设备属性描述GB/T40027-2021解读
- 信息安全技术引入可信第三方的实体鉴别及接入架构规范GB/T28455-2012
- 担保存货第三方管理规范GB/T31300-2014解读
- 电子商务信用B2B第三方交易平台信用规范GB/T33717-2017解析
- 合格评定管理体系第三方审核报告内容要求和建议GB/T27022-2017
- 电子商务信用第三方网络零售平台交易纠纷处理通则GB/T34827-2017
- GB/T38320-2019要求下的智能家用电子系统终端设备与统一接入服务平台接口
- 信息技术信息设备互连智能家用电子系统终端统一接入服务平台总体技术要求GB/T37723-2019
- 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求GB/T38322-2019
- 信息技术信息设备互连智能家用电子系统终端设备属性描述GB/T40027-2021解读
- 信息技术信息设备互连智能家用电子系统终端统一接入服务平台总体技术要求GB/T37723-2019
- 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求GB/T38322-2019
- GB/T38320-2019要求下的智能家用电子系统终端设备与统一接入服务平台接口
- 信息技术信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求GB/T38322-2019
