发布时间 : 星期六 文章智慧城市公共信息平台平台接口与服务要求更新完毕开始阅读
接口采用 WebService 方式，接口协议使用 SOAP 协议，提供标准的 WSDL 文 件。 智慧城市公共信息平台-平台接口与服务要求 8
5.3 5.3 接口地址
公共信息目录服务（以下简称）主要有三个 公共信息目录服务（以下简称）主要有三个 公共信息目录服务（以下简称）主要有三个 wsdl 地址，不同的 地址，不同的 wsdl 下有不同的方法，文说明。这是根据 webservice 的 soap 协议开放出来的 协议开放出来的 wsdl 地址，第三方应用可以根据实际的部署服务器来使它。
1) 基础接口 WSDL 文件地址： http://
2) 发现接口 WSDL 文件地址： http://
? 目录检索结果提取 – queryCatalogResult
3) 资源服务接口： http://
? 资源检索结果提取 – getResourceResultDetail
4) 发现接口 WSDL 文件地址： http://
完成资源的检索与发现需要根据以下步骤来操作：
1) 第一步：初始化操作。调用基础接口的“目录服务初始化”获得一个会 话标识符以后每次调用接口都需要次标识符。
2) 第二步：查询公共信息目录操作。调用发现接口的“目录检索”组织好查询参数，发起交易，获得查询结果。注：这里的查询结果只有返回命中的查询记录数。比如：返回值是100，那么表示有100条记录符合查询条件，这个时候需要发起“公共信息目录检索结果提取”交易才能提取
智慧城市公共信息平台-平台接口与服务要求 9
查询的结果。如果发回值是0，表示没有符合查询条件的记录。 3) 第三步：查询公共信息目录对应的资源。这里的操作也是和上面一样，调用“资源检索”先要查询下是否有符合查询条件的资源。有资源记录的话，然后在调用“资源检索结果提取”提取符合条件的资源信息。
4) 第四步：假如调用接口结束后，可调用基础接口里的“目录服务终止”来释放会话标识符资源信息。
智慧城市公共信息平台-平台接口与服务要求 10
6 业务接口 要求
6.1 6.1 基础接口 要求 6.1.1 目录服务初始化
公共信息目录服务初始化用于建立客户端与服务端的会话，所有其他服务都必须依赖会话。会话的持续时间为30分钟，若会话持续30分钟没有活动，则会话自动终止。本次初始化
5
作用是客户端认证同时获取会话标识符，后续发起交易时需要传递该会话标识符。 1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion 可选
StringStringStringString String 50
客户端协议版本号
客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 版本号 2.
idAuthentication idAuthentication idAuthentication idAuthenticationidAuthentication idAuthenticationidAuthenticationidAuthentication idAuthentication 必选
StringStringStringString String 50
用户名 用户名 用户名 /密 码
认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 身份标识及其密码。 身份标识及其密码。 身份标识及其密码。 身份标识及其密码。 身份标识及其密码。 格式“ 格式“ <用户名 用户名 >/< 密 码>” 3.
implementationId implementationId implementationId implementationIdimplementationIdimplementationIdimplementationId implementationId implementationId 可选
StringStringStringString String 50
应用标识 应用标识
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 三方应用编号 三方应用编号 三方应用编号 4.
implementationName implementationName implementationName implementationNameimplementationNameimplementationNameimplementationName implementationName implementationName 可选
StringStringStringString String 200200200
应用名称 应用名称
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户管系统中注册的 户
6
管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 第三方应用名称 第三方应用名称 第三方应用名称 5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选
element element 其他信息 其他信息 备用
2. 请求报文体模板
智慧城市公共信息平台-平台接口与服务要求 11
序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.
referenceIdreferenceIdreferenceIdreferenceId referenceId 必选
StringStringStringString String 50
会话标识 会话标识 当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 当验证成功时返回，否 则设置为空 则设置为空 2.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion 必选
StringStringStringString String 50
服务端协议版本号
服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 号 3.
resultresult result 必选
Boolean Boolean 处理结果 处理结果
服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话
7
的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 求。 truetruetrue 表示建立会话 成功， falsefalse falsefalse表示建立会 表示建立会 话失败，此时 话失败，此时 话失败，此时 话失败，此时 referenceIdreferenceIdreferenceIdreferenceIdreferenceIdreferenceId 为空。 4.
pubKey pubKey pubKeypubKey 必选
StringStringStringString String 64
加解密公钥 加解密公钥 5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选
element element 其他信息 其他信息 备用 4. 响应报文体模板
公共信息目录服务终止将结束服务端与客户端的会话，与会话相关的资源将被释放。 1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.
referenceIdreferenceIdreferenceIdreferenceId referenceId 必选
StringStringStringString String 50
会话标识 会话标识
要终止的会话编号 要终止的会话编号 要终止的会话编号 要终止的会话编号 2.
closeReason closeReasoncloseReasoncloseReason closeReason closeReasoncloseReason 可选
StringStringStringString String 50
终止原因 终止原因 3.
otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选
element element 其他信息 其他信息 备用 2. 求报文体模板
8