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

附件七
智慧城市公共信息平台
平台接口与服务要求
(试行)
中华人民共和国住房和城乡建设部建筑节能与科技司
二〇一三年三月
目次
1 范围 1
2 规范性引用文件 2
3 术语与定义 3
4 接口服务概述 5
接口服务组成 5
接口技术要求 6
5 总体要求 7
消息结构 7
请求报文范例 7
响应报文范例 7
接口方式 7
接口地址 8
使用说明 8
6 业务接口要求 10
基础接口要求 10
目录服务初始化 10
目录服务终止 11
认证授权 12
发现接口要求 13
资源目录检索 13
资源目录检索结果提取 15
资源服务接口要求 17
资源内容检索 17
资源内容检索结果提取 18
管理接口要求 20
目录资源元数据管理 20
附录A 要求所涉及的结构表 23
databaseList组成 23
服务功能列表 23
elementSetName结果集属性 24
opResult属性表 24
singleRecord参数表 24
元数据管理类型定义 24
核心元数据属性集 25
关系运算符属性集 27
位置运算符属性集 27
资源自描述Result属性集 27
附录B QUERY-RES-DATA说明 30
dataQuery资源检索申请结构 31
结构化资源检索申请结构 31
非结构化资源申请结构 32
资源检索结果提取结构 33
结构化资源singleRecord范例 33
非结构化资源singleRecord范例 34
附录C 平台接口要求SCHEMA 36
附录D QUERY-RPN范例 65
示例一 65
示例二 65
附录E 资源目录范例 68
资源目录要求SCHEMA 68
结构化资源目录模板 89
非结构化资源目录模板 98
1 范围
本要求是《智慧城市公共信息平台建设指南》建设要求系列之接口与服务要求。
本部分要求分两大部分描述平台接口要求,第一部分:总体要求,总体要求描述消息的总体结构、接口访问方、接口地址、使用说明。第二部分:业务接口要求,具体描述每个业务应用服务接口的要求。也就是每一个业务接口要求套在总体要求内。只有使用业务接口要求+总体要求才能正常使用信息平台的应用服务来发现,查询,管理资源。
本部分适用于参与公共信息平台设计和研发人员,系统维护人员及要求接入公共信息平台的外部应用的开发人员。
2 规范性引用文件
下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分,鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本部分。
GB/T -2007 政务信息资源目录体系第1部分:总体框架;
GB/T -2007 政务信息资源目录体系第2部分:技术要求;
GB/T -2007 政务信息资源目录体系第3部分:核心元数据;
GB/T -2007 政务信息资源目录体系第4部分: 政务信息资源分类;
GB/T -2007 政务信息资源目录体系第5部分:政务信息资源标识符编码方案;
本文<业务接口要求> 引用《GB/T -2007》中的附录A 目录服务接口;
本文<附录A 要求所涉及的结构表>引用《GB/T -2007》中的附录A 目录服务接口,及引用《GB/T -2007》中的附录C 政务信息资源目录服务属性集
本文<附录D QUERY-RPN范例>引用《GB/T -2007》中的附录F 检索串示例9.
3 术语与定义
GB/T 19710-2005中规定的与以下术语和定义适用于本部分。
目录
针对拥有共性的数据资源/文件资源进行分类,并且为该分类赋予唯一的资源标识符,该部分分类及分类描述的集合统称为资源目录,简称目录。
结构化资源
公共信息平台共享的二维库表结构数据,统称为结构化资源。
非结构化资源
公共信息平台共享的非二维库表结构数据,例如:文本文件、视频、网络访问资源等统称为非结构化资源。