智慧城市公共信息平台平台接口与服务要求Word格式文档下载.docx

1、GB/T 21063.4 GB/T 21063.4 -2007 政务信息资源目录体系 第 4部分： 政务信息资源分类；GB/T 21063.5 -2007 政务信息资源目录体系 第 5部分：政务信息资源标识 部分：政务信息资源标识 符编码方案； 本文 引用 GB/T 21063.2 GB/T 21063.2 -2007 中的附录 A 目录服务 接口；附录 A 要求 所涉及的结构表 所涉及的结构表 所涉及的结构表 所涉及的结构表 引用 引用 GB/T 21063.2 GB/T 21063.2 -2007 中的附 中的附 中的附 录 A 目录服务接口，及引用 目录服务接口，及引用 目录服务接口，及

2、引用 GB/T 21063.2 GB/T 21063.2 -2007 中的附录 中的附录 C 政务信息资源目 录服务属性集附录 D QUERY D QUERY -RPN 范例 引用 GB/T 21063.2 GB/T 21063.2 -2007 中的附录 中的附录 F 检 索串示例 9.33 术语 与定义GB/T 19710 -2005 中规定的与以下术语和义适用于本部分。 目录针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有共性的数据资源 /文件资 源进行分类，并且为该赋予唯一的文件资 源进行分类，并且为该赋予唯一的文件资 源进行分类，并且为该赋予唯一的文件资

3、 源进行分类，并且为该赋予唯一的文件资 源进行分类，并且为该赋予唯一的文件资 源进行分类，并且为该赋予唯一的文件资 源进行分类，并且为该赋予唯一的源标识符，该部分类及描述的集合统称为资目录简。 结构化资源公共信息平台享的二维库表结构数据，统称为化资源。 非结构化资源公共信息平台享的非二维库表结构数据，例如：文本件、视频网络访 公共信息平台享的非二维库表结构数据，例如：文本件、视频网络访 问资源等统称为非结构化。 数据交换管理者管理信息资源结点的机构。 交换内容提供者提供信息资源交换内容的机构。 交换内容使用者使用信息资源交换内容的机构。 前置环境应用单 位接入端系统软硬件及相关网络环境组成的前

4、置元环境。 目录交换按订阅模式进行目录资源数据的交换； 桥接系统业务数据库与共享的桥接器，保持 交换 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 ； 变更捕捉捕捉数据 资源 变更情况 。 数据转入以固定间隔时轮询变更登记表，读取其中的 录并将这些约以固定间隔时轮询变更登记表，读取其中的 录并将这些约以固定间隔时轮询变更登记表，读取其中的 录并将这些约格式组成 XML 报文，存储到共享库的换出表中 ；非结构化数据文件直接通过服务传输至交换中心

5、 器，并有非结构化数据文件直接通过服务传输至交换中心器，并有4分发非结构化数据文件。 数据交换路由以固定时间隔轮询应用单位换入表，拆解 以固定时间隔轮询应用单位换入表，拆解 XML 报文，根据目标库自动分拣 报文，根据目标库自动分拣 ；非结构化数据文件直接通过服务传输至交换中心 器，并有非结构化数据文件直接通过服务传输至交换中心 器，并有分发非结构化数据文件。 数据转出独立运行的进程， 以固定间隔时轮询交换库中的 入表，读取其以固定间隔时轮询交换库中的 入表，读取其XML 报文，并将数据按定制的格式同步到共享库中 。非结构化数据文件描述信息存储在队列中，由各服务器根分 非结构化数据文件描述信息

6、存储在队列中，由各服务器根分 别从中心文件服务器获取所需数据。 交换管理程序完成 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 等功能一套 等功能一套 程序 ， 部署于中心。 Web 服务基于 webservice 技术开放的 服务接口，采用约定的 服务接口，采用约定的 XML 作为交易数据接口， 提供给客户端调用。 WSDLWeb 服务描述文件， 一个用

7、来描述 一个用来描述 Web 服务和说明如何与 服务和说明如何与 Web 服务通信的 服务通信的 XML 语言。为用户提供详细的接口说明 。 访问认证公共信息平台提供用户认证 服务，由托管应系统的客端调于验公共信息平台提供用户认证 服务，由托管应系统的客端调于验公共信息平台提供用户认证 服务，由托管应系统的客端调于验用户是否合法； 应用单位接入公共信息平台的机构单位。 主管 单位公共 信息平台的管理单位 。 数据 中心公共 信息平台 的组成部分， 是公共信息平台数据及应用系统存储的地方 。54 接口服务概述4.1 接口服务组成信息资源目录服务包含三种接口，即信息资源基础服务接口、资源服务接口（

8、发现接口、资源接口）、信息资源管理服务接口。其中，基础接口是将资源服务接口和管理接口中基础性的操作定义成一个公共接口。这3 类接口实现了信息资源的发现功能、检索功能和管理功能。基础接口：提供会话管理功能和服务自描述功能，包含有目录服务初始化接口、目录服务终止接口和服务自描述接口。发现接口：提供信息资源元数据检索功能和信息资源元数据检索结果提取功能，包含有目录检索接口以及目录检索结果提取接口。这些接口本身并不提供资源，而是提供资源基本信息和如何去获得这些资源的元数据。资源接口：根据发现接口获得信息资源元数据，定位、查找资源具体内容的接口，包含资源内容检索接口及资源内容结果提取接口。管理接口：提供

9、元数据管理的功能，包含信息资源元数据管理接口。城市公共信息平台接口服务组成见图1.智慧城市公共信息平台基础接口服务资源接口服务管理接口服务服务初始化认证授权服务终止发现服务资源服务资源元数据新增服务资源元数据更新服务资源元数据删除服务资源目录检索资源目录结果提取资源内容检索资源内容结果图1. 城市公共信息平台接口服务组成图64.2 4.2 接口技术要求 接口技术要求 接口技术要求 接口技术要求 接口技术要求a） 提供基于 SOAP 协议的 web 服务接口b） 支持跨语言、操作系统调用75 总体 要求5. 1 消息结构每个交易消息 每个交易消息 （包括请求和应答 包括请求和应答 包括请求和应答

10、 包括请求和应答 ）有一个是名字（ 有一个是名字（ 有一个是名字（ 有一个是名字（ Message Name Message Name），交易消息 ），交易消息 ），交易消息 以 XML 格式表达的，根据 格式表达的，根据 XML 的定义，每个 的定义，每个 XML 文件需要有特定的 Root Tag Root Tag （根 标记），在本 标记），在本 标记），在本 要求 中，用交易名称 中，用交易名称 +请求类别作为根节点，如初始化接口的包 请求类别作为根节点，如初始化接口的包 根节点为 initRequest ，而响应包的根节点为 ，而响应包的根节点为 initResponse 。根节点下

11、之间放业 。根节点下之间放业 务接口数据。5. 1.1 请求报文范例 idAuthentication/implementationId/implementationName/otherInfo/initRequest5.1.2 响应报文范例 referenceIdprotocolVersion/protocolVersionpubKey/pubKeyresult/resultotherInfo/otherInfo/initResponse5.2 5.2 接口方式接口采用 WebService 方式，接口协议使用 SOAP 协议，提供标准的 WSDL 文 件。85.3 5.3 接口地址公共信息

12、目录服务（以下简称）主要有三个 公共信息目录服务（以下简称）主要有三个 公共信息目录服务（以下简称）主要有三个 wsdl 地址，不同的 地址，不同的 wsdl 下有不同的方法，文说明。这是根据 webservice 的 soap 协议开放出来的 协议开放出来的 wsdl 地址，第三方应用可以根据实际的部署服务器来使它。1） 基础接口 WSDL 文件地址： http:/: 端 口/es/catalogbase?wsdl 目录服务初始化 initCatalogService 目录服务终止 stopCatalogService2） 发现接口 WSDL 文件地址：/es/digcatalog? 目录检

13、索 queryCatalogList 目录检索结果提取 queryCatalogResult3） 资源服务接口： 端口 /es/digresource? 资源检索 getResourceResultset 资源检索结果提取 getResourceResultDetail4） 发现接口 WSDL 文件地址： 资源元数据管理 metadataManage5.4 5.4 使用说明完成资源的检索与发现需要根据以下步骤来操作：1） 第一步：初始化操作。调用基础接口的“目录服务初始化”获得一个会 话标识符以后每次调用接口都需要次标识符。2） 第二步：查询公共信息目录操作。调用发现接口的“目录检索”组织好查

14、询参数，发起交易，获得查询结果。注：这里的查询结果只有返回命中的查询记录数。比如：返回值是100，那么表示有100条记录符合查询条件，这个时候需要发起“公共信息目录检索结果提取”交易才能提取9查询的结果。如果发回值是0，表示没有符合查询条件的记录。3） 第三步：查询公共信息目录对应的资源。这里的操作也是和上面一样，调用“资源检索”先要查询下是否有符合查询条件的资源。有资源记录的话，然后在调用“资源检索结果提取”提取符合条件的资源信息。4） 第四步：假如调用接口结束后，可调用基础接口里的“目录服务终止”来释放会话标识符资源信息。106 业务接口 要求6.1 6.1 基础接口 要求6.1.1 目录

15、服务初始化公共信息目录服务初始化用于建立客户端与服务端的会话，所有其他服务都必须依赖会话。会话的持续时间为30分钟，若会话持续30分钟没有活动，则会话自动终止。本次初始化作用是客户端认证同时获取会话标识符，后续发起交易时需要传递该会话标识符。1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明1.protocolVersion protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersionprotocolVers

16、ionprotocolVersionprotocolVersion protocolVersion可选StringStringStringString String50客户端协议版本号客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 版本号2.idAuthentication idAuthentication idAuthentication idAuthenticationidAuthentication idAuthenticationidAuthenticationidAuthenticatio

17、n idAuthentication必选用户名 用户名 用户名 /密 码认证信息。包含用户 认证信息。包含用户 身份标识及其密码。 身份标识及其密码。 格式“ 格式“ /”3.implementationId implementationId implementationId implementationIdimplementationIdimplementationIdimplementationId implementationId implementationId应用标识 应用标识在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用

18、在公共信息平台用 在公共信息平台用 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 三方应用编号 三方应用编号 三方应用编号4.implementationName implementationName implementationName implementationNameimplementationNameimplementationNameimplementationName implementationName implementationName200200200应用名称 应用名称在公共

19、信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 第三方应用名称 第三方应用名称 第三方应用名称5.otherInfootherInfootherInfo otherInfo otherInfootherInfoelement element其他信息 其他信息备用2. 请求报文体模板 V1.0testApp/12456implementationId1impleme

20、ntationName测试应用3. 响应报文体11序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明referenceIdreferenceIdreferenceIdreferenceId referenceId会话标识 会话标识当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 则设置为空 则设置为空服务端协议版本号服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端

21、协议实现的版本 号resultresult resultBoolean Boolean处理结果 处理结果服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 求。 truetruetrue 表示建立会话 成功， f

22、alsefalse falsefalse表示建立会 表示建立会 话失败，此时 话失败，此时 话失败，此时 话失败，此时 referenceIdreferenceIdreferenceIdreferenceIdreferenceIdreferenceId 为空。pubKey pubKey pubKeypubKey64加解密公钥 加解密公钥4. 响应报文体模板 cde2db52-8cee-45f4-9cec-f8a68ebbad5ccatalogtrue初始化服务成功6.1.2 目录服务终止公共信息目录服务终止将结束服务端与客户端的会话，与会话相关的资源将被释放。要终止的会话编号 要终止的会话编号