附件七
智慧城市公共信息平台
平台接口与服务要求
(试 行)
中国城市科学研究会
数字城市工程研究中心
二〇一三年四月
I
目 次
1 范围 .............................................................................................................................................. 1
2 规范性引用文件 ........................................................................................................................... 2
3 术语与定义................................................................................................................................... 3
4 接口服务概述 ............................................................................................................................... 5
4.1 接口服务组成 ................................................................................................................... 5
4.2 接口技术要求 ................................................................................................................... 6
5 总体要求....................................................................................................................................... 7
5.1 消息结构 ........................................................................................................................... 7
5.1.1 请求报文范例 ........................................................................................................ 7
5.1.2 响应报文范例 ........................................................................................................ 7
5.2 接口方式 ........................................................................................................................... 7
5.3 接口地址 ........................................................................................................................... 8
5.4 使用说明 ........................................................................................................................... 8
6 业务接口要求 ............................................................................................................................. 10
6.1 基础接口要求 ................................................................................................................. 10
6.1.1 目录服务初始化 .................................................................................................. 10
6.1.2 目录服务终止 ...................................................................................................... 11
6.1.3 认证授权 .............................................................................................................. 12
6.2 发现接口要求 ................................................................................................................. 13
6.2.1 资源目录检索 ...................................................................................................... 13
6.2.2 资源目录检索结果提取 ...................................................................................... 15
6.3 资源服务接口要求 ......................................................................................................... 17
6.3.1 资源内容检索 ...................................................................................................... 17
6.3.2 资源内容检索结果提取 ...................................................................................... 18
6.4 管理接口要求 ................................................................................................................. 20
6.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 关系运算符属性集 .................................................................................................... 27
表 A.9 位置运算符属性集 .................................................................................................... 27
表 A.10 资源自描述 Result 属性集 ..................................................................................... 27
附录 B QUERY-RES-DATA 说明 ........................................................................................................ 30
B.1 dataQuery 资源检索申请结构 ....................................................................................... 31
B.1.1 结构化资源检索申请结构 ................................................................................. 31
B.1.2 非结构化资源申请结构 ..................................................................................... 32
B.2 资源检索结果提取结构 ................................................................................................. 33
智慧城市公共信息平台-平台接口与服务要求
II
B.2.1 结构化资源 singleRecord 范例 ........................................................................ 33
B.2.1 非结构化资源 singleRecord 范例 .................................................................... 34
附录 C 平台接口要求 SCHEMA .................................................................................................... 36
附录 D QUERY-RPN 范例 ................................................................................................................ 65
D.1 示例一 ............................................................................................................................. 65
D.2 示例二 ............................................................................................................................. 65
附录 E 资源目录范例 .................................................................................................................... 68
E.1 资源目录要求 SCHEMA ................................................................................................. 68
E.2 结构化资源目录模板 ..................................................................................................... 89
E.3 非结构化资源目录模板 ................................................................................................. 98
1
1 范围
本要求是《智慧城市公共信息平台建设指南》建设要求系列之接口与服
务要求。
本部分要求分两大部分描述平台接口要求,第一部分:总体要求,总体
要求描述消息的总体结构、接口访问方、接口地址、使用说明。第二部分:业务
接口要求,具体描述每个业务应用服务接口的要求。也就是每一个业务接口要求
套在总体要求内。只有使用业务接口要求+总体要求才能正常使用信息平台的应
用服务来发现,查询,管理资源。
本部分适用于参与公共信息平台设计和研发人员,系统维护人员及要求
接入公共信息平台的外部应用的开发人员。