ICS 35.110 L 79 中华人民共和国国家标准 GB/T38322—2019 信息技术 信息设备互连 第三方智能家用电子系统与 终端统一接入服务平台接口要求 Information technology—Information device interconnection- Interface requirements between third-party smart home electric system and general terminal access service platform 2019-12-10发布 2020-07-01实施 国家市场监督管理总局 发布 国家标准化管理委员会 GB/T 38322—2019 目 次 前言 范围 1 2 规范性引用文件 3 术语和定义 4 缩略语 通用数据格式 5 6 消息参数定义 GB/T38322—2019 前言 本标准按照GB/T1.1一2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国信息技术标准化技术委员会（SAC/TC28）提出并归口。 本标准起草单位：阿里巴巴（北京）软件服务有限公司、中国电子技术标准化研究院、小米科技有限 责任公司、深圳赛西信息技术有限公司、上海庆科信息技术有限公司、京东方科技集团股份有限公司、松 下家电研究开发（杭州）有限公司、杭州海康威视数字技术股份有限公司、青岛聚好联科技有限公司。 本标准主要起草人：安就、刘大鹏、杨宏、郭雄、周珏嘉、江小威、余晖、林峰、陈小松、刘涛、刘丽、 宋晓佳、蒲灵峰、辛玲、周小俊、钱晓东、邵佩、邓晓平、董征。 Ⅲ GB/T383222019 信息技术信息设备互连 第三方智能家用电子系统与 终端统一接入服务平台接口要求 1范围 本标准规定了第三方智能家用电子系统及终端与服务平台简的通用数据格式以及消息参数定义。 本标准适用于智能家用电子系统应用客户端和服务平台的设计、开发和部署 2规范性引用文件 2 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T37723一2019信息技术信息设备互连智能家用电子系统终端统一接人服务平台总体 技术要求 3 术语和定义 GB/T37723一2019界定的术语和定义适用于本文件。 4缩略语 下列缩略语适用于本文件。 UTC国际协调时间（CoordinatedUniversalTime) UUID通用唯一标识符（UniversallyUniqueIdentifier） 5通用数据格式 5 5.1第三方智能家用电子系统请求接口通用数据格式 第三方智能家用电子系统请求接口通用数据格式见表1。 表1第三方智能家用电子系统请求接口通用数据格式 元素 字段名称 说明 接口名称 name 根据使用的接口分别填写 接口类型 thirdPartylnterface 服务平台提供给第三方智能家用电子系统的服务接口 1 GB/T 38322—2019 表1(续) 元素 字段名称 说明 version 协议版本信息 sign 签名值 system key 应用客户端密钥的标识值，由制定服务平台统一颁发 timestamp UTC时间戳，自1970年1月1日起计算的时间，单位为秒（s） url 请求源（第三方智能家用电子系统）域名 设备标识，第三方智能家用电子系统设备在服务平台的唯 devicelD 标识，值为平台分配给设备的UUID account 用户账号 request token 当前用户登录服务平台获取的令牌 host 请求的操作源 响应控制类命令时，需将之前下发命令中携带的标识信息作 请求内容 rspID 为rsp标识值 deviceID 设备标识 value 设置状态值 which 用户数据采集源（设备）的设备标识信息 attribute updateTime 设备状态值更新时间 parameters extension 设备状态更新附加信息 服务平台的用户账号标识 token 登录服务平台后获得的令牌 查询数据的时间范围，UTC(s)时间。如果为空，则代表查询 duration 最近一次记录的数据 ID data ID 数据标识 5.2 服务平台请求接口通用数据格式 服务平台请求接口通用数据格式见表2。 表 2 服务平台请求接口通用数据格式 元素 字段名称 说明 接口名称 name 根据使用的接口分别填写 接口类型 thirdPartylnterface 服务平台提供给第三方智能家用电子系统的服务接口 intent 操作描述 请求内容 devicelD 设备标识 devices subscriptionID 订阅标识 2