智慧城市公共信息平台平台接口与服务要求(2)

作用是客户端认证同时获取会话标识符，后续发起交易时需要传递该会话标识符。 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. 请求报文体模板 V1.0 testApp/12456 1 测试应用 3. 响应报文体

智慧城市公共信息平台-平台接口与服务要求 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. 响应报文体模板 cde2db52-8cee-45f4-9cec-f8a68ebbad5c

V1.0 catalog true 初始化服务成功 6.1.2 目录服务终止

公共信息目录服务终止将结束服务端与客户端的会话，与会话相关的资源将被释放。 1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

referenceIdreferenceIdreferenceIdreferenceId referenceId 必选

StringStringStringString String 50

会话标识 会话标识

要终止的会话编号 要终止的会话编号 要终止的会话编号 要终止的会话编号 2.

closeReason closeReasoncloseReasoncloseReason closeReason closeReasoncloseReason 可选

StringStringStringString String 50

终止原因 终止原因 3.

otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选

element element 其他信息 其他信息 备用 2. 求报文体模板 cde2db52-8cee-45f4-9cec-f8a68ebbad5c 智慧城市公共信息平台-平台接口与服务要求

8

12

< closeReason >终止使用 6.1.3 认证授权

认证授权主要是公钥获取接口服务，用于根据客户端应用的请求，取出最新的加解密公钥并返回给客户端的过程。

公钥获取与其他接口不同，不需要用户验证，不需要会话标识。调用客户端只有获取公钥后对用户认证信息进行加密才能完成其服务调用。 整个密码加解密的处理过程如下图所示： 图2. .密码加解密的处理过程图

1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选

element element 其他信息 备用

2. 请求报文体模板

智慧城市公共信息平台-平台接口与服务要求 13

3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

pubKey pubKey pubKeypubKey 必选

StringStringStringString String 8 公钥

用于加解密码的密钥 2.

opResultopResult opResult opResult 必选

element element 操作结果

参见《表 参见《表 参见《表 参见《表 A.6A.6A.6 opResultopResult opResult opResult 属性表》之 属性表》之 属性表》之 说明 3.

otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选

element element 其他信息 备用

4. 响应报文体模板 < pubkey>catalog < opStatus>true < opRetCode >code < opRetMsg >message 6.2 6.2 发现接口 要求

9

6.2.1 资源目录检索

公共信息目录检索是服务端根据客户端指定的检索条件，在服务器端从元数据库中检索并标识出匹配的元数据记录，并将元数据记录保存在结果集中的过程。

结果集的保存时间与会话标识一致，当会话结束后，响应的结果集将被同步删除。 智慧城市公共信息平台-平台接口与服务要求 14

1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

referenceIdreferenceIdreferenceIdreferenceId referenceId 必选

StringStringStringString String 50

会话标识 会话标识 2.

replaceIndicatoreplaceIndicato replaceIndicato replaceIndicato replaceIndicato replaceIndicatoreplaceIndicatoreplaceIndicator 必选

Boolean Boolean

结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 标志

truetruetrue 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 询结果， 询结果， falsefalse falsefalse表示保留 表示保留 原来的查询结果 原来的查询结果 原来的查询结果 3.

resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID 必选

StringStringStringString String 200200200

指定的查询 指定的查询 指定的查询 指定的查询 指定的查询 结果集名称 结果集名称 若存在同名的结果集， 若存在同名的结果集， 若存在同名的结果集， 若存在同名的结果集， 若存在同名的结果集， 需要根据 需要根据 replaceIndicatorreplaceIndicator replaceIndicator replaceIndicator replaceIndicator replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判断是 判断是 否需要覆盖结果集。 否需要覆盖结果集。 否需要覆盖结果集。 否需要覆盖结果集。 4.

databaseName databaseNamedatabaseName databaseName databaseName databaseName databaseNames 必选

Element Element Element

要查询的元 要查询的元 要查询的元 要查询的元 要查询的元 数据库名称 数据库名称 数据库名称 数据库名称 数据库名称 列表

客户端指定的要查询元数据库名称列表 元数据库名称列表 元数据库名称列表 元数据库名称列表 5.

query query query

10