ICs 35.110 GB L 79 中华人民共和国国家标准 GB/T36478.4--2019 物联网 信息交换和共享 第4 部分:数据接口 Internet of things--Information sharing and exchanging--Part 4:Data interface 2019-08-30发布 2020-03-01实施 国家市场监督管理总局 发布 中国国家标准化管理委员会 GB/T 36478.4-2019 目次 前言 范围 规范性引用文件 术语和定义 缩略语 .. 概述 接口要求 6.1约定 6.2提供方推送接口 6.2.1数据推送请求 6.2.2 推送数据 6.2.3 目录数据推送请求 6.2.4 推送目录数据 6.3需求方获取接口 6.3.1 数据获取请求 6.3.2 获取数据： 6.3.3 目录数据获取请求 6.3.4 获取目录数据 GB/T 36478.4-2019 前言 GB/T36478&物联网信息交换和共享分为以下4个部分： 第1部分：总体架构； 第2部分：通用技术要求； 第3部分：元数据： 第4部分，数据接口。 本部分为GB/T36478的第4.部分。 本部分按照GB/T.1.12009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本部分由全国信息技术标准化技术委员会（SAC/TC28）提出并归口。 本部分起草单位：南京三宝科技股份有限公司、中国电子技术标准化研究院、深圳赛西信息技术有 限公司、无锡物联网产业研究院、中国电子科技集团公司第十五研究所、上海集成通信设备有限公司、中 通服咨询设计研究院有限公司、贝分科技（杭州）有限公司。 本部分主要起草人：邹涛、徐冬梅、张晖、陈书义、付根利、师晓敏、俞浚、洪磊余晖、林峰、陈小松 GB/T 36478.4-2019 物联网信息交换和共享 第4部分：数据接口 1范围 GB/T36478的本部分规定了物联网系统与外部物联网系统进行信息交换和共享时数据接口的数 据推送请求、推送数据、数据获取请求、获取数据、目录获取请求、获取目录数据、目录数据推送请求和推 送自录数据等接口参数。 本部分适用于物联网系统之间信息交换和共享的设计、系统开发以及运行维护管理。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T33745-2017物联网术语 GB/T36478.1一2018物联网信息交换和共享第1部分：总体架构 3术语和定义 GB/T33745-2017.GB/T36478.12018界定的术语和定义适用手本文件。 4 缩略语 下列缩略语适用于本文件 WSDi.Web服务措述语言(Web Services Description Language) 5 概述 依据GB/T.36478.1=2018中的规定，交换和共享数据模块/系统既可以是物联网系统中的二个功 能模块，也可以是一个独立的系统。通过数据接口，数据提供方物联网系统将交换和共享数据导人交换 和共享数据模块/系统，数据需求方物联网系统从交换和共享数据模块/系统获取物联网数据。数据接 口如图1所示。 GB/T 36478.4-2019 目录发布 目录注册 交换和共享数据 模块/系统 目录数据管理 目录访间 交换和共享数据提供/获取接口 数据接口 交换和共享数据 交换和共享数据 数据提供方 数雷求方 物联网系线 物联网系统 图1数据接口 6接口要求 6.1 约定 本章给出了信息交换和共享数据接口的基本接口方法和参数，数据接口应与物联网系统的软件平 台无关，接口宣采用webService技术实现。以下的接口描述，只规定了物联网系统间数据交换和共享 应实现的基本接口及参数，各系统所实现的具体接口方法、参数个数、参数类型由系统的WSDL文件进 行描述： 为方便系统实现，接口名和参数名采用英文名称。 6.2 提供方推送接口 6.2.1数据推送请求 接口名:pushDataRequest 描述：数据提供方物联网系统在数据推送前，向交换和共享模块/系统发送数据推送请求。 参数：见表1。 表 1 pushDataRequest 参数名 插述 类型 可选性 Usernamic 数据提供方的用户名 字符串 必选 Password 数据提供方的密码 字符串 必选 Sender 数据提供方名称 字符串 可选 返回值： 0：允许推送数据： 其他：拒绝推送请求，返回值具体含义可由系统定义 GB/T 36478.4-2019 6.2.2推送数据 接口名：pushData 描述：数据提供方物联网系统调用此方法，将需要推送的数据发送给交换和共享模块/系统。 参数：见表2 表2 pushData 参数名 描述 类型 可选性 ID 物联网数据标识符 字符串 可选 数据类型及格式由WSDL Data 推送的数据 必选 文件定义 返回值： 1推送失败； 0.推送成功 >0：推送成功的数据量（字节数或数据条数）。 6.2.3目录数据推送请求 接口名：pushRegDirDataRequest 描述：数据提供方物联网系统在向交换和共享模块/系统推送目录数据前，向交换和共享模块/系统 发送目录注册请求， 参数：见表3， 表3pushRegDirDataRequest 参数名 插述 类型 可选性 Username 数据提供方的用户名 字符串 必选 Pasgword 数据提供方的密码 字符串 必选 Sender 数据提供方名称 字符串 可选 返回值： 0.充许推送目录数据； 其他：拒绝推送自录数据，返回值具体含义可由系统定义。 6.2.4推送目录数据 接口名：pushRegDirData 描述：数据提供方物联网系统调用此方法，将需要注册的目录数据发送给交换和共享模块/系统。 参数：见表4。