书 书 书犐犆犛 ３５ ． １１０ 犔 ７９ 中华人民共和国国家标准 犌犅 ／ 犜 ３８３２２ — ２０１９ 信息技术 　 信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求 犐狀犳狅狉犿犪狋犻狅狀狋犲犮犺狀狅犾狅犵狔 — 犐狀犳狅狉犿犪狋犻狅狀犱犲狏犻犮犲犻狀狋犲狉犮狅狀狀犲犮狋犻狅狀 — 犐狀狋犲狉犳犪犮犲狉犲狇狌犻狉犲犿犲狀狋狊犫犲狋狑犲犲狀狋犺犻狉犱狆犪狉狋狔狊犿犪狉狋犺狅犿犲犲犾犲犮狋狉犻犮狊狔狊狋犲犿犪狀犱犵犲狀犲狉犪犾狋犲狉犿犻狀犪犾犪犮犮犲狊狊狊犲狉狏犻犮犲狆犾犪狋犳狅狉犿 ２０１９  １２  １０ 发布 ２０２０  ０７  ０１ 实施 国家市场监督管理总局 国家标准化管理委员会 发布书 书 书目 　　 次 前言 Ⅲ ………………………………………………………………………………………………………… １ 　 范围 １ ……………………………………………………………………………………………………… ２ 　 规范性引用文件 １ ………………………………………………………………………………………… ３ 　 术语和定义 １ ……………………………………………………………………………………………… ４ 　 缩略语 １ …………………………………………………………………………………………………… ５ 　 通用数据格式 １ …………………………………………………………………………………………… ６ 　 消息参数定义 ３ …………………………………………………………………………………………… Ⅰ 犌犅 ／ 犜 ３８３２２ — ２０１９ 前 　　 言 　　 本标准按照 ＧＢ ／ Ｔ１．１ — ２００９ 给出的规则起草 。 请注意本文件的某些内容可能涉及专利 。 本文件的发布机构不承担识别这些专利的责任 。 本标准由全国信息技术标准化技术委员会 （ ＳＡＣ ／ ＴＣ２８ ） 提出并归口 。 本标准起草单位 ： 阿里巴巴 （ 北京 ） 软件服务有限公司 、 中国电子技术标准化研究院 、 小米科技有限责任公司 、 深圳赛西信息技术有限公司 、 上海庆科信息技术有限公司 、 京东方科技集团股份有限公司 、 松下家电研究开发 （ 杭州 ） 有限公司 、 杭州海康威视数字技术股份有限公司 、 青岛聚好联科技有限公司 。 本标准主要起草人 ： 安 ? 、 刘大鹏 、 杨宏 、 郭雄 、 周珏嘉 、 江小威 、 余晖 、 林峰 、 陈小松 、 刘涛 、 刘丽 、 宋晓佳 、 蒲灵峰 、 辛玲 、 周小俊 、 钱晓东 、 邵佩 、 邓晓平 、 董征 。 Ⅲ 犌犅 ／ 犜 ３８３２２ — ２０１９ 信息技术 　 信息设备互连第三方智能家用电子系统与终端统一接入服务平台接口要求 １ 　 范围 本标准规定了第三方智能家用电子系统及终端与服务平台间的通用数据格式以及消息参数定义 。 本标准适用于智能家用电子系统应用客户端和服务平台的设计 、 开发和部署 。 ２ 　 规范性引用文件 下列文件对于本文件的应用是必不可少的 。 凡是注日期的引用文件 ， 仅注日期的版本适用于本文件 。 凡是不注日期的引用文件 ， 其最新版本 （ 包括所有的修改单 ） 适用于本文件 。 ＧＢ ／ Ｔ３７７２３ — ２０１９ 　 信息技术 　 信息设备互连 　 智能家用电子系统终端统一接入服务平台总体技术要求 ３ 　 术语和定义 ＧＢ ／ Ｔ３７７２３ — ２０１９ 界定的术语和定义适用于本文件 。 ４ 　 缩略语 下列缩略语适用于本文件 。 ＵＴＣ 国际协调时间 （ ＣｏｏｒｄｉｎａｔｅｄＵｎｉｖｅｒｓａｌＴｉｍｅ ） ＵＵＩＤ 通用唯一标识符 （ ＵｎｉｖｅｒｓａｌｌｙＵｎｉｑｕｅＩｄｅｎｔｉｆｉｅｒ ） ５ 　 通用数据格式 ５ ． １ 　 第三方智能家用电子系统请求接口通用数据格式 第三方智能家用电子系统请求接口通用数据格式见表 １ 。 表 １ 　 第三方智能家用电子系统请求接口通用数据格式 元素 字段名称 说明 接口名称 ｎａｍｅ 根据使用的接口分别填写 接口类型 ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ 服务平台提供给第三方智能家用电子系统的服务接口 １ 犌犅 ／ 犜 ３８３２２ — ２０１９ 表 １ （ 续 ） 元素 字段名称 说明 请求内容 ｓｙｓｔｅｍ ｒｅｑｕｅｓｔ ｐａｒａｍｅｔｅｒｓ ＩＤ ｖｅｒｓｉｏｎ ｓｉｇｎ ｋｅｙ ｔｉｍｅｓｔａｍｐ ｕｒｌ ｄｅｖｉｃｅＩＤ ａｃｃｏｕｎｔ ｔｏｋｅｎ ｈｏｓｔ ｒｓｐＩＤ ｄｅｖｉｃｅＩＤ ａｔｔｒｉｂｕｔｅｖａｌｕｅ ｗｈｉｃｈ ｕｐｄａｔｅＴｉｍｅ ｅｘｔｅｎｓｉｏｎ ａｃｃｏｕｎｔ ｔｏｋｅｎ ｄｕｒａｔｉｏｎ ｄａｔａＩＤ 协议版本信息 签名值 应用客户端密钥的标识值 ， 由制定服务平台统一颁发 ＵＴＣ 时间戳 ， 自 １９７０ 年 １ 月 １ 日起计算的时间 ， 单位为秒 （ ｓ ） 请求源 （ 第三方智能家用电子系统 ） 域名 设备标识 ， 第三方智能家用电子系统设备在服务平台的唯一 标识 ， 值为平台分配给设备的 ＵＵＩＤ 用户账号 当前用户登录服务平台获取的令牌 请求的操作源 响应控制类命令时 ， 需将之前下发命令中携带的标识信息作 为 ｒｓｐ 标识值 设备标识 设置状态值 用户数据采集源 （ 设备 ） 的设备标识信息 设备状态值更新时间 设备状态更新附加信息 服务平台的用户账号标识 登录服务平台后获得的令牌 查询数据的时间范围 ， ＵＴＣ （ ｓ ） 时间 。 如果为空 ， 则代表查询 最近一次记录的数据 数据标识 ５ ． ２ 　 服务平台请求接口通用数据格式 服务平台请求接口通用数据格式见表 ２ 。 表 ２ 　 服务平台请求接口通用数据格式 元素 字段名称 说明 接口名称 ｎａｍｅ 根据使用的接口分别填写 接口类型 ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ 服务平台提供给第三方智能家用电子系统的服务接口 请求内容 ｉｎｔｅｎｔ ｄｅｖｉｃｅｓｄｅｖｉｃｅＩＤ ｓｕｂｓｃｒｉｐｔｉｏｎＩＤ 操作描述 设备标识 订阅标识 ２ 犌犅 ／ 犜 ３８３２２ — ２０１９ ６ 　 消息参数定义 ６ ． １ 　 第三方智能家用电子系统请求接口 ６ ． １ ． １ 　 第三方智能家用电子系统查询终端设备注册信息 ６ ． １ ． １ ． １ 　 功能描述 扩展功能 ， 用于第三方智能家用电子系统请求服务平台来查看绑定的设备注册信息 。 ６ ． １ ． １ ． ２ 　 消息参数定义 第三方智能家用电子系统查看终端设备注册信息消息参数定义见表 ３ 。 表 ３ 　 第三方智能家用电子系统查看终端设备注册信息消息参数定义 元素 字段名称 必选 说明 名称 ｇｅｔＤｅｖｉｃｅＩｎｆｏ 是 获取服务平台设备注册信息 类型 ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ 是 服务平台提供给第三方智能家用电子系统的服务接口 请求内容 ｓｙｓｔｅｍ ｒｅｑｕｅｓｔ ｐａｒａｍｅｔｅｒｓ ｖｅｒｓｉｏｎ ｓｉｇｎ ｋｅｙ ｔｉｍｅｓｔａｍｐ ｕｒｌ ｐｒｉｖａｃｃｏｕｎｔ ａｌｉｎｋａｃｃｏｕｎｔ ｔｏｋｅｎ ｄｅｖｉｃｅＩＤ ｇｅｔＤｅｖｉｃｅＩｎｆｏＤａｔａＩＤ 是 协议版本信息 是 签名值 是 请求源 ， 第三方智能家用电子系统的密钥的标识值 是 时间戳 是 请求源 ， 第三方智能家用电子系统域名 否 用户在第三方智能家用电子系统的账号 否 用户在服务平台的账号 否此 ｔｏｋｅｎ 是 ａｌｉｎｋａｃｃｏｕｎｔ 账号登录后 ， 服务平台返回给 应用客户端的值 是 设备标识 是 数据标识 ６ ． １ ． ２ 　 第三方智能家用电子系统发送用户设定通知 ６ ． １ ． ２ ． １ 　 功能描述 扩展功能 ， 用于第三方智能家用电子系统将用户操作设备的记录通知服务平台 。 ６ ． １ ． ２ ． ２ 　 消息参数定义 第三方智能家用电子系统发送用户设定通知消息参数定义见表 ４ 。 表 ４ 　 第三方智能家用电子系统发送用户设定通知消息参数定义 元素 字段名称 必选 说明 名称 ｎｏｔｉｆｙＵｓｅｒＡｃｔｉｏｎ 是 第三方智能家用电子系统发送用户设定通知 类型 ｔｈｉｒｄＰａｒｔｙＩｎｔｅｒｆａｃｅ 是 服务平台提供给第三方智能家用电子系统的服务接口 ３ 犌犅 ／ 犜 ３８３２２ — ２０１９ 表 ４ （ 续 ） 元素 字段名称 必选 说明 请求内容 ｓｙｓｔｅｍ ｒｅｑｕｅｓｔ ｐａｒａｍｅｔｅｒｓ ｖｅｒｓｉｏｎ ｓｉｇｎ ｋｅｙ ｔｉｍｅｓｔａｍｐ ｕｒｌ ａｃｃｏｕｎｔ ｔｏｋｅｎ ｈｏｓｔ ｄｅｖｉｃｅＩＤ ａｔｔｒｉｂｕｔｅｖａｌｕｅ ｕｐｄａｔｅＴｉｍｅ ｅｘｔｅｎｓｉｏｎ ｎｏｔｉｆｙＵｓｅｒＡｃｔｉｏｎＤａｔａＩＤ 是 协议版本信息 是 签名值 是 请求源 ， 第三方智能家用电子系统的密钥的标识值 是 时间戳 是 请求源 ， 第三方智能家用电子系统域名 是 请求源使用的服务平台账号 是 登录服务平台后获得的会话令牌 是 请求操作源 是 设备标识 是 设置状态值 否 设备状态值更新时间 否 设备状态更新附加信息 是 数据标识 ６ ． １ ． ３ 　 第三方智能家用电子系统验证服务平台用户身份 ６ ． １ ． ３ ． １ 　 功能描述 扩展功能 ， 用于第三方智能家用电子系统验证服务平台的用户身份 。 ６ ． １ ． ３ ． ２ 　 消息参数定义 第三方智能家用电子系统验证服务平台用户身份的消息参数定义见表 ５ 。 表 ５ 　 第三方智能家用电子系统验证服务平台用户身份消息参数定义 元素 字段名称 必选 说明 名称 ａｕｔｈｅ