智慧城市公共信息平台-附件七：接口与服务要求.docx

1、附件七智慧城市公共信息平台平台接口与服务要求（试 行）中华人民共和国住房和城乡建设部建筑节能与科技司二一三年三月I目 次1 范围 .12 规范性引用文件 .23 术语与定义 .34 接口服务概述 .54.1 接口服务组成 .54.2 接口技术要求 .65 总体要求 .75.1 消息结构 .75.1.1 请求报文范例 .75.1.2 响应报文范例 .75.2 接口方式 .75.3 接口地址 .85.4 使用说明 .86 业务接口要求 .106.1 基础接口要求 .106.1.1 目录服务初始化 .106.1.2 目录服务终止 .116.1.3 认证授权 .126.2 发现接口要求 .136.2.

2、1 资源目录检索 .136.2.2 资源目录检索结果提取 .156.3 资源服务接口要求 .176.3.1 资源内容检索 .176.3.2 资源内容检索结果提取 .186.4 管理接口要求 .206.4.1 目录资源元数据管理 .20附录 A 要求所涉及的结构表 .23表 A.1 databaseList 组成 .23表 A.2 服务功能列表 .23表 A.3 elementSetName 结果集属性 .24表 A.4 opResult 属性表 .24表 A.5 singleRecord 参数表 .24表 A.6 元数据管理类型定义 .24表 A.7 核心元数据属性集 .25表 A.8 关系运

3、算符属性集 .27表 A.9 位置运算符属性集 .27表 A.10 资源自描述 Result 属性集 .27附录 B QUERY-RES-DATA 说明 .30B.1 dataQuery 资源检索申请结构 .31B.1.1 结构化资源检索申请结构 .31B.1.2 非结构化资源申请结构 .32B.2 资源检索结果提取结构 .33智慧城市公共信息平台-平台接口与服务要求IIB.2.1 结构化资源 singleRecord 范例 .33B.2.1 非结构化资源 singleRecord 范例 .34附录 C 平台接口要求 SCHEMA .36附录 D QUERY-RPN 范例 .65D.1 示例一

4、 .65D.2 示例二 .65附录 E 资源目录范例 .68E.1 资源目录要求 SCHEMA .68E.2 结构化资源目录模板 .89E.3 非结构化资源目录模板 .9811 范围 本要求是智慧城市公共信息平台建设指南建设要求系列之接口与服务要求。 本部分要求分两大部分描述平台接口要求，第一部分：总体要求，总体要求描述消息的总体结构、接口访问方、接口地址、使用说明。第二部分：业务接口要求，具体描述每个业务应用服务接口的要求。也就是每一个业务接口要求套在总体要求内。只有使用业务接口要求+总体要求才能正常使用信息平台的应用服务来发现，查询，管理资源。 本部分适用于参与公共信息平台设计和研发人员，

5、系统维护人员及要求接入公共信息平台的外部应用的开发人员。智慧城市公共信息平台-平台接口与服务要求22 规范性引用文件下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。GB/T 21063.1-2007 政务信息资源目录体系 第 1 部分：总体框架；GB/T 21063.2-2007 政务信息资源目录体系 第 2 部分：技术要求；GB/T 21063.3-2007 政务信息资源目录体系 第 3 部分：

6、核心元数据；GB/T 21063.4-2007 政务信息资源目录体系 第 4 部分： 政务信息资源分类；GB/T 21063.5-2007 政务信息资源目录体系 第 5 部分：政务信息资源标识符编码方案； 本文 引用GB/T 21063.2-2007中的附录 A 目录服务接口； 本文引用GB/T 21063.2-2007中的附录 A 目录服务接口，及引用GB/T 21063.2-2007中的附录 C 政务信息资源目录服务属性集 本文引用 GB/T 21063.2-2007中的附录 F 检索串示例 9.智慧城市公共信息平台-平台接口与服务要求33 术语与定义GB/T 19710-2005 中规定

7、的与以下术语和定义适用于本部分。 目录针对拥有共性的数据资源/文件资源进行分类，并且为该分类赋予唯一的资源标识符，该部分分类及分类描述的集合统称为资源目录，简称目录。 结构化资源公共信息平台共享的二维库表结构数据，统称为结构化资源。 非结构化资源公共信息平台共享的非二维库表结构数据，例如：文本文件、视频、网络访问资源等统称为非结构化资源。 数据交换管理者管理信息资源结点的机构。 交换内容提供者提供信息资源交换内容的机构。 交换内容使用者使用信息资源交换内容的机构。 前置环境应用单位接入端系统软硬件及相关网络环境组成的应用单位前置系统的单元环境。 目录交换按订阅模式进行目录资源数据的交换； 桥接

8、系统业务数据库与共享数据库的桥接器，保持交换数据库与共享数据库的同步； 变更捕捉捕捉数据资源变更情况。 数据转入以固定间隔时间轮询变更登记表，读取其中的记录，并将这些记录以约定的格式组成 XML 报文，存储到共享库的换出表中；智慧城市公共信息平台-平台接口与服务要求4非结构化数据文件直接通过文件服务传输至交换中心文件服务器，并有中心分发非结构化数据文件。 数据交换路由以固定时间间隔轮询应用单位换入表，拆解 XML 报文，根据目标库自动分拣； 非结构化数据文件直接通过文件服务传输至交换中心文件服务器，并有中心分发非结构化数据文件。 数据转出独立运行的进程，以固定间隔时间轮询交换库中的换入表，读取

9、其中的XML 报文，并将数据按定制的格式同步到共享库中。非结构化数据文件描述信息存储在信息队列中，由各服务器根据队列信息分别从中心文件服务器获取所需数据文件。 交换管理程序完成数据交换审批流程、交换监控、交换调度、系统管理等功能一套程序，部署于中心。 Web 服务基于 webservice 技术开放的服务接口，采用约定的 XML 作为交易数据接口，提供给客户端调用。 WSDLWeb 服务描述文件，一个用来描述 Web 服务和说明如何与 Web 服务通信的XML 语言。为用户提供详细的接口说明。 访问认证公共信息平台提供用户认证服务，由托管应用系统的客户端调用，用于验证用户是否合法； 应用单位接

10、入公共信息平台的机构单位。 主管单位公共信息平台的管理单位。 数据中心智慧城市公共信息平台-平台接口与服务要求5公共信息平台的组成部分，是公共信息平台数据及应用系统数据存储的地方。智慧城市公共信息平台-平台接口与服务要求64 接口服务概述4.1 接口服务组成信息资源目录服务包含三种接口，即信息资源基础服务接口、资源服务接口(发现接口、资源接口)、信息资源管理服务接口。其中，基础接口是将资源服务接口和管理接口中基础性的操作定义成一个公共接口。这 3 类接口实现了信息资源的发现功能、检索功能和管理功能。基础接口：提供会话管理功能和服务自描述功能，包含有目录服务初始化接口、目录服务终止接口和服务自描

11、述接口。发现接口：提供信息资源元数据检索功能和信息资源元数据检索结果提取功能，包含有目录检索接口以及目录检索结果提取接口。这些接口本身并不提供资源，而是提供资源基本信息和如何去获得这些资源的元数据。资源接口：根据发现接口获得信息资源元数据，定位、查找资源具体内容的接口，包含资源内容检索接口及资源内容结果提取接口。管理接口：提供元数据管理的功能，包含信息资源元数据管理接口。城市公共信息平台接口服务组成见图 1.智慧城市公共信息平台基础接口服务 资源接口服务管理接口服务服务初始化 认证授权 服务终止 发现服务 资源服务资源元数据新增服务资源元数据更新服务资源元数据删除服务资源目录检索资源目录结果提取资源内容检索资源内容结果提取图 1. 城市公共信息平台接口服务组成图