DB4201-T 536.2-2017“云端武汉”政务数据资源目录体系与数据交换技术规范 第2部分：数据共享交换

ICS

35.240.01L

67备案号：0071-2017

DB4201 DB4201/T

536.2—2017“云端武汉”政务数据资源目录体系与数据交换技术规范第

2

部分：数据共享交换Technical

specifications

government

data

catalog

system

and

data

exchange

Part

data

share

exchange 武汉市质量技术监督局武汉市互联网信息办公室发

布DB4201/T

536.2—2017前言

...............................................................................

III1

范围

..............................................................................

12

规范性引用文件

....................................................................

13

术语与定义

........................................................................

14

缩略语

............................................................................

35

数据交换体系总体框架

..............................................................

35.1 总体技术架构

..................................................................

35.2 共享交换服务建设流程

..........................................................

36

数据共享交换技术规范

..............................................................

66.1

概述

..........................................................................

66.2

交换模式

......................................................................

66.3

数据接口交换规则

..............................................................

76.4

前置数据库交换规则

...........................................................

167

数据资源交换管理规范

.............................................................

247.1

概述

.........................................................................

247.2

角色职责

.....................................................................

247.3

管理环节

.....................................................................

257.4

制度建设

.....................................................................

26附录

A（资料性附录） 政务共享交换服务表单示例.......................................

27附录

B（资料性附录） 数据接口参数示例...............................................

28附录

C（资料性附录）

调用示例

...................................................

32参考文献

............................................................................

35DB4201/T

536.2—2017 本标准按照GB/T

《标准化工作导则 第1部分：标准的结构和编写》给出的规则起草。本标准由武汉市互联网信息办公室提出并归口。本标准起草单位：武汉市信息中心、武汉市标准化研究院。本标准主要起草人：王留军、袁远明、崔新强、黄勇、张洁、肖迎霜、董波涛、向小雪、李文、刘肖骏。DB4201/T

536.2—2017

1范围本标准规定了“云端武汉”政务数据共享交换中的术语与定义、缩略语、数据交换体系总体框架、数据共享交换技术规范、数据资源交换管理规范。共享交换政务数据资源。2规范性引用文件件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。武政办[2015]146号 《武汉市政务数据资源共享管理暂行办法》武网发[2016]9号 《武汉市政务云平台数据资源安全管理实施细则》3 术语与定义下列术语和定义适用于本文件。3.1行政主管部门 administrative

department行政机关或者其他依法经授权、受委托行使行政职能的组织。3.2武汉政务云数据中心

government

cloud

center的数据共享提供支撑的技术服务平台。简称“数据中心”。3.3政务数据资源

data

resource合。3.4DB4201/T

数据项

item各行政主管部门可共享的单个政务数据资源不可再分割的组成元素。3.5服务及服务项

service

item数据项操作的集合，数据项可来自于多个政务数据资源，而服务是整个服务项集合的总称。3.6数据需求方

demand

side指通过数据中心获取政务数据资源的各行政主管部门。3.7管理者

manager指数据中心的运维单位。3.83.9

数据提供方

指向数据中心提供数据资源的各行政主管部门。共享交换服务

exchange

service的数据资源由各行政主管部门自身的业务信息系统所提供、产生、发布并进行运行管理。3.10共享信息服务系统

information

对各行政主管部门提供的共享交换服务及接口统一维护管理的平台系统。3.11接口

interface形式包含：数据接口、前置数据库两种。3.12访问密钥标识/秘密访问密钥

API_key/

API_secret根据非对称加密的方法来验证某个请求者身份。DB4201/T

536.2—20173.13会话

指用户与服务器进行的一次交互，包括从发起到退出的整个过程。4 缩略语下列缩略语适用于本文件。HTTP：超文本传输协议（HyperText

）API：应用程序编程接口（Application

Interface）URL：统一资源定位符（

Resource

Locator）XML：可扩展标记语言（

）5 数据交换体系总体框架5.1 总体技术架构5.1.1 组成政务数据共享交换体系技术总体架构包括交换信息库和共享交换服务系统两方面组成。5.1.2 交换信息库提供的共享交换服务信息。5.1.3 共享交换服务系统 前置数据库子系统用系统的独立性。 数据接口子系统为各行政主管部门对外共享交换服务数据接口提供注册、挂接、配置、授权等管理。交换管理子系统实现对整个数据交换过程的配置、部署、执行和整个共享交换服务系统运行进行监控、管理。5.2 共享交换服务建设流程如图1所示，共享交换服务建设包括4个环节：a)市政务数据主管部门；DB4201/T

b)

5

后提交市政务数据主管部门备案；c) 展设计开发，并由数据中心工作人员完成该项数据服务的对接工作，全部工作应在

30

日内完成；d) 考核：市政务数据主管部门对各部门数据共享工作响应程度、实施进度、工作质量进行考核。管部门将取消其通过数据中心共享其他部门数据的资格。数据需求方数据中心数据提供方开始整理办事事项涉及的共享数据资源及相关信息创建服务申请单登记所需数据项和对应政务部门拒绝结束申请与反审核服务

同意申请单已有收集各政务部门反馈结果服务接口实施挂接通知结果给服务涉及相关政务部门提供方结合需求方申请内容，给出反馈意见与需求方、提供方协商协商结果形成需求方、提供方、管理方的三方确认单行政机关是否已有相关服务没有各政务部门分别进行新建服务工作DB4201/T

536.2—2017图1 共享交换服务建设流程图5.2.1 政务数据共享交换申请单各行政主管部门登记共享交换服务申请内容，需按照附录A中表A.1进行相关信息填写。5.2.2 政务数据共享交换确认单A中表信息填写。…

...DB4201/T

…

...6 数据共享交换技术规范6.1 概述规范要求，同时也为第三方相关单位的研发工作提供标准依据。6.2 交换模式6.2.1 数据接口类型各行政主管部门的数据接口，应遵循如图2所示的交换模式进行政务数据资源交换。各数据提供方封装整理后，统一返回至各数据需求方。数据提供方公安 民政 工商数据接口 数据接口 数据接口共享信息服务系统根据注册发布的数据接口信息，分别调取访问共享信息服务系统API认证机制注册

发布接口注册

发布接口

接口订阅

授权管理

监控

管理

...统一访问共享信息服务系统，调取授权范围内的数据接口公安数据接口

民政数据接口

工商数据接口

共享信息服务系统封装返回结果，统一返回各政务部门…

...数据需求方图2 数据接口交换模式示意图DB4201/T

536.2—20176.2.2 前置数据库类型利用数据中心采用数据库模式进行政务数据交换的各行政主管部门，应遵循如图

3

发布，根据定时抓取、定时推送或

上传文件导入三种形式，将各行政主管部门业务数据传至共享接口、

文件导出三种方式，访问自身权限范围内的数据业务表信息。数据提供方公安数据库

民政数据库

工商数据库

…

...注册

发布数据业务表

业务表注册

发布数据业务表

业务表订阅

授权管理

监控...件导入等方式，将提供方政务数据传至前置交换区共享信息服务系统前置交换区数据库管理统一访问共享信息服务系统，查阅授权范围内的业务表公安数据库

民政数据库

工商数据库

共享信息服务系统封装返回结果，统一返回各政务部门…

...数据需求方图3 前置数据库交换模式示意图6.3 数据接口交换规则6.3.1 数据接口管理流程 数据接口注册、发布流程各数据提供方的数据接口在共享信息服务系统中集中注册、挂接、发布，其工作流程如图4注册发布包括6个环节：DB4201/T

a) 中心管理员申请；b) 登记、注册：由各数据提供方行政主管部门登记自身对外提供的接口及相关参数信息；c) 提交：由行政主管部门提交发布申请至数据中心；d) 审核：由平台中心对各行政主管部门的数据接口内容进行审核；e) 口是否运行正常；f) 接口，查阅相关的描述说明，并申请数据接口的访问权限。DB4201/T

536.2—2017图4 数据接口注册、发布流程图数据需求方数据中心开始选择所需数据接口提出订阅申请www.b提交审核不通过审核订阅申请通过分配访问权限配置、测试接口测试成功结束DB4201/T

数据接口订阅、授权流程进行调取授权，其工作流程如图54个环节：a) 申请：各数据需求方通过共享信息服务系统统一提出对已发布数据接口的调取申请；b) 审核：由平台中心对各行政主管部门的数据接口订阅请求进行审核；c) 授权：为各数据需求方授权相应的数据接口调取权限；d) 方成功获取所需的接口数据。图5 数据接口订阅、授权流程图方成功获取所需的接口数据。10DB4201/T

536.2—20176.3.2 技术要求 提供方数据接口发布规范.1 数据接口示例数据提供方所发布的数据接口内容，参照附录B表示例进行描述。.2 接口命名规范数据提供方数据接口的命名遵循以下规则：a) 名为无缝连写，首词汇采用小写字母，其余每个词汇的缩写的首字母采用大写；b)称前增加“虚拟名称”用于区分不同的行政主管部门。最终格式例如：“虚拟名称.真实数据接口名称（gaj.getPersonByIDCard）”；c) 虚拟名称命名应为半角格式的英文无缝连写；d) 本规则范围内不允许接口的命名与其对应版本号同时重复。.3 数据接口基础属性规范地址、访问帐号、访问密码、提供方名称、技术联系人、联系人电话，属性具体说明如下：a) 接口版本号定义：描述数据接口的版本信息注解：必选项；最大出现次数为1b) 接口描述定义：描述数据接口的功能作用注解：必选项；最大出现次数为1c)接口类型定义：描述数据接口的访问方式类型注解：必选项；最大出现次数为1d) 返回报文类型定义：描述调取本数据接口返回报文的格式类型（或格式）注解：必选项；最大出现次数为1e) 访问地址定义：描述数据接口的调取访问地址注解：必选项；最大出现次数为1f) 访问帐号定义：描述调取数据接口时所需的帐号注解：必选项；最大出现次数为1g) 访问密码定义：描述调取数据接口时所需的密码注解：必选项；最大出现次数为1h) 提供方名称定义：数据接口提供单位名称DB4201/T

注解：必选项；最大出现次数为1i) 技术联系人定义：负责数据接口对接调试工作技术人员姓名注解：必选项；最大出现次数为1j) 联系人电话定义：负责数据接口对接调试工作技术人员的手机号码或座机号码注解：必选项；最大出现次数为.4 请求参数规范调取数据提供方数据接口所需的各请求参数描述应遵循以下规则：a) 各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的请求参数为无缝连写；b) 各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c) 如下：1) 名称定义：描述请求参数的英文名称注解：必选项；最大出现次数为

12) 类型定义：描述请求参数对应的数据类型注解：必选项；最大出现次数为

13) 数据长度定义：描述请求参数最大长度限制注解：必选项；最大出现次数为

14) 是否必须定义：描述请求参数是否为必填项注解：必选项；最大出现次数为

15) 默认值内容注解：可选项；最大出现次数为

16) 描述定义：说明请求参数的含义及用途注解：必选项；最大出现次数为

.5 响应参数规范数据提供方数据接口的响应返回结果中各参数描述应遵循以下规则：a) 各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的响应参数为无缝连写；b) 各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c) 所有的响应数据编码皆为

utf-8

格式；d) 每个响应参数的属性包括：名称、类型、数据长度、示例值、描述，属性具体说明如下：12DB4201/T

536.2—20171) 名称定义：描述响应参数的英文名称注解：必选项；最大出现次数为

12) 类型定义：描述请求参数对应的数据类型注解：必选项；最大出现次数为

13) 数据长度定义：描述响应参数最大长度限制注解：必选项；最大出现次数为

14) 示例值定义：描述响应参数的示例数值，为需求方提供返回示例注解：必选项；最大出现次数为

15) 描述定义：说明响应参数的含义及用途注解：必选项；最大出现次数为

.6 错误结果参数规范调取数据提供方数据接口出现错误时，其返回结果内容应遵循以下规则：a) 各参数命名应为半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的错误结果参数为无缝连写；b) 各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c) 每个错误结果参数的属性包括：名称、类型、数据长度、示例值、描述，属性具体说明如下：1) 名称定义：描述错误结果参数的英文名称注解：必选项；最大出现次数为

12) 类型定义：描述错误结果参数对应的数据类型注解：必选项；最大出现次数为

13) 数据长度定义：描述错误结果参数最大长度限制注解：必选项；最大出现次数为

14) 示例值定义：描述错误结果参数的示例数值，为需求方提供返回错误结果示例注解：必选项；最大出现次数为

15) 描述定义：说明错误结果参数的含义及用途注解：必选项；最大出现次数为

.7 错误代码定义数据提供方数据接口应包括错误代码及其对应的描述说明，每个错误代码定义的属性包括：错误代码、错误消息、错误说明，属性具体说明如下：a) 错误代码13DB4201/T

定义：描述错误结果参数的代码编号注解：必选项；最大出现次数为

1b) 错误消息定义：描述错误代码对应的错误消息内容注解：可选项；最大出现次数为

1c) 错误说明定义：描述错误代码对应的中文描述注解：必选项；最大出现次数为

需求方数据接口使用规范.1 访问地址规范数据需求方调取提供方数据接口时，其访问地址为共享信息服务系统提供的统一访问

URL。URL的格式例如：公共访问

地址公共请求参数+业务请求参数。URL

地址参数说明：a) URL

地址中各参数应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的请求参数为无缝连写；b) URL

地址中各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c) URL

里的所有请求参数名和参数值的数据编码皆为

utf-8

格式；d) 参数名与参数值拼装起来的

长度小于

个字符时，可以用

发起请求；参数类型含byte[]类型或拼装完成的请求

过长时，应用

发起请求；e) 公共请求参数详见

公共请求参数规范章节；f) 业务请求参数详见

请求参数规范章节。.2 公共请求参数规范数据需求方在调取数据接口时，应按照共享信息服务系统要求，传入系统所需的公共请求参数，公共请求参数描述遵循以下规则：a)各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有公共请求参数为无缝连写；b)各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c) 每个公共请求参数的属性包括：名称、类型、是否必须、默认值、描述，属性具体说明如下：1) 名称定义：描述公共请求参数的英文名称注解：必选项；最大出现次数为

12) 类型定义：描述公共请求参数对应的数据类型注解：必选项；最大出现次数为

13) 数据长度定义：描述公共请求参数最大长度限制注解：必选项；最大出现次数为

14) 是否必须定义：描述公共请求参数是否为必填项注解：必选项；最大出现次数为

114名称类型数据长度是否必须默认值描述methodString20api_keyString50API_KeyString10，时区为，例如：2016-01-01

10String1.0String2048DB4201/T

536.2—20175) 默认值数值内容注解：可选项；最大出现次数为

16)描述定义：说明公共请求参数的含义及用途注解：必选项；最大出现次数为

1d) 目前梳理的公共请求参数如表

1

所示。表1 数据接口访问公共请求参数表.3 数据接口示例共享信息服务系统向数据需求方提供所需数据接口调取方式，如附录

B

表

B.2

示例所示。 认证机制.1 API

认证简介为保证数据接口访问调取的安全性，防止恶意、超权限访问数据接口，各数据需求方行政主管部

API_Secret加密的方法来验证各行政主管部门身份，API_Key

(以下简称为“AK”)是系统为每个访问者分配的唯一标识；API_Secret

(AS”)“AS”与请求参数信息组合加密形成需求方的验证密匙，具体方法详见

签名算法章节描述。AS

信息严格保密，仅限行政主管部门管理员和数据中心管理员有权查阅。.2 API

认证方式共享信息服务系统获取各数据需求方发送的

HTTP

a) 获取数据需求方的

若存在，则执行后续的验证工作；b)根据签名算法得出本次数据接口调取请求的合法签名内容，与数据需求方请求时提供的

值比对，若不一致，系统将拒绝该请求；若一致，则执行后续的验证工作；15DB4201/T

c)求：“服务器接收到请求时间<{timestamp}+10min”；其中，timestamp代表需求方调取数据接口的请求时间。10分钟行操作。.3 签名算法为了防止调取

API

数据接口过程中被黑客恶意篡改，数据需求方在调取任何一个

API

sign

MD5

内容过程如下：a) 对所有

API

参数和

byte[]据参数名称的

ASCII

码表的顺序排序。如：foo=1,

bar=2,

foo_bar=3,

foobar=4

序是

foo=1,

foo_bar=3,

；b)将排序好的参数名和参数值拼装在一起，根据上一步的示例得到的结果为：bar2foo1foo_bar3foobar4；c) 把拼装好的字符串采用

算法，在拼装的字符串前后加上

API

，再进行摘要，如：md5(AS+bar2foo1foo_bar3foobar4+AS)；d) 将进行摘要后所得到的字节流结果统一转成大写字母。6.4 前置数据库交换规则6.4.1 前置数据库管理流程 数据库业务表注册、发布流程.1 定时抓取模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由共享信息服务系统定时抓取各数据提供方的数据库业务表数据模式的工作流程如图

6

所示，注册发布包括

4

个环节：a) 纸质或电子文档形式完成）；b)登记、注册：由数据中心管理员登记各数据提供方的业务数据库相关信息；c) 置、调试前置交换区抓取各数据提供方数据库业务表数据功能；d)访问权限。16数据提供方数据中心开始提交自身数据库及业务表相关信息（线下）www.b登记、注册数据库业务表信息配置、测试数据抓取测试成功发布结束DB4201/T

536.2—2017图6 数据库注册、发布流程图（定时抓取模式）.2 定时推送模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由各数据提供方定时推送自身数据库业务表数据至共享信息服务系统模式的工作流程如图74a)或电子文档形式完成）；b)数据库表结构；c)业务表数据功能是否正常（线下完成）；d) 限。17数据提供方数据中心开始提交自身业务表相关信息（线下）配置、测试数据推送www.b分配交换区发布结束DB4201/T

图7 数据库注册、发布流程图（定时推送模式）.3FTP

文件上传模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由各数据提供方将自身数据库业务表数据制作成相关文件导入至共享信息服务系统模式的工作流程如图

8

包括

4

个环节：a) 或电子文档形式完成）；b) 结构；c)

换区导入自身数据库业务表数据功能是否正常（线下完成）；d) 务表的访问权限。18数据提供方数据中心开始提交自身业务表相关信息（线下）配置、测试FTP上传文件导入测www.b分配交换区发布结束DB4201/T

536.2—2017图8 数据库注册、发布流程图（FTP

文件上传模式） 数据库业务表订阅、授权流程各数据需求方通过共享信息服务系统统一提出申请，由数据中心管理员审核授权对所选数据库业务表进行访问。具体工作流程如图

9

所示，订阅授权包括以下

4

个环节：a)申请：各数据需求方通过共享信息服务系统统一提出对已发布数据库业务表的访问申请；b) 审核：由平台中心对各数据需求方的数据库业务表订阅请求进行审核；c) 授权：为各数据需求方授权相应的数据库业务表访问权限；d) 需求方成功获取所需的业务表数据。19数据需求方数据中心开始选择所需数据库业务表提出订阅申请提交审核www.b不通过审核订阅申请通过分配访问权限配置、测试测试成功结束DB4201/T

图9 数据库业务表订阅、授权流程图6.4.2技术要求 建表规范创建前置交换区表结构需遵循以下规范：a)前置交换区数据库类型目前暂定为

Oracle，所有业务表均建成“周期快照事实”，后续可根据实际需要扩展其他类型格式的数据库；b)

期分区。每个分区内含本周期全量数据，历史表数据保留半年（例如：8

月

1

日，清空当年

1月份历史数据）；c)

要分区。每个表内含本周期全量数据，历史表数据根据存储情况制定保留方案；20DB4201/T

536.2—2017d)

100

8

月

1

日，清空当年

1

月份历史数据）；e)

100

案；f) 据，历史表数据根据存储情况制定保留方案；g) 每张业务表中新增时间戳字段（，以下简称“时间戳”），用于记录每条数据的更新传输时间。字段具体的赋值方式详见后文各更新传输数据模式规范中描述介绍；h)内各字段具体的赋值方式详见各更新传输数据模式规范中的描述介绍。提供方规范.1 数据库配置参数示例数据中心管理员为每个提供方分配前置交换区数据库，建立相应表结构时，需要各数据提供方按附录

B

表

B.3

示例出示的相关参数填写。.2数据库配置参数说明结合上述数据库配置参数示例，各参数要求如下：a) 提供方名称定义：描述提供数据库信息的单位名称注解：必选项；最大出现次数为

1b) 数据库名称定义：描述数据提供方业务数据库英文名称注解：必选项；最大出现次数为

1c) 数据库类型根据实际需要扩展其他类型格式的数据库注解：必选项；最大出现次数为

1d) 数据库

IP

地址定义：描述提供方业务数据库

地址注解：必选项；最大出现次数为

1e) 数据库

MAC

地址定义：描述提供方业务数据库

地址注解：可选项；最大出现次数为

1f) 端口定义：描述提供方业务数据库对应端口内容注解：必选项；最大出现次数为

1g) 用户名定义：描述访问提供方业务数据库时需登录的用户名21DB4201/T

注解：必选项；最大出现次数为

1h)密码定义：描述访问提供方业务数据库时需登录的密码注解：必选项；最大出现次数为

1i) 技术联系人定义：负责数据接口对接调试工作技术人员姓名注解：必选项；最大出现次数为

1j) 联系人电话定义：负责数据接口对接调试工作技术人员的手机号码或座机号码注解：必选项；最大出现次数为

1k) 业务表信息定义：描述提供方数据库各业务表的相关信息，包含业务表名称、业务表说明、业务表更新频率、业务表当前记录数、业务表每周期更新数据量、业务表数据保存周期六个子属性，以下逐一介绍注解：必选项；最大出现次数为

N1) 业务表名称定义：描述数据库业务表英文名称注解：必选项；最大出现次数为

12) 业务表说明定义：数据库业务表存储内容及含义的中文概要说明注解：必选项；最大出现次数为

13) 业务表更新频率定义：描述数据库业务表数据的更新频率周期（天、周、月、年）注解：必选项；最大出现次数为

14) 业务表当前记录数定义：描述数据库业务表当前数据量，为分配前置交换区做参考依据注解：必选项；最大出现次数为

15) 业务表每周期更新数据量定义：描述数据库业务表每个更新周期内变动的数据量，为分配前置交换区做参考依据注解：必选项；最大出现次数为

16) 业务表数据保存周期定义：描述数据库业务表数据保存周期，为分配前置交换区做参考依据注解：必选项；最大出现次数为

1l) 业务表字段信息

3

逐一介绍注解：必选项；最大出现次数为

N1) 字段名称定义：描述业务表字段英文名称注解：必选项；最大出现次数为

12) 字段描述定义：描述业务表字段含义及说明注解：必选项；最大出现次数为

122DB4201/T

536.2—20173) 字段类型定义：描述业务表字段存储时对应的数据类型注解：必选项；最大出现次数为

.3 定时抓取模式规范采用共享信息服务系统“定时抓取”各数据提供方数据库业务表数据信息方式时，结合数据库配

业务表信息、业务表字段信息，属性具体说明参照

.2

章节中的相关描述说明。在本模式下，各业务表的“时间戳”字段和“更新记录表”内容由共享信息服务系统在抓取数据时自动赋值。.4 定时推送模式规范采用各数据提供方“定时推送”自身数据库业务表数据信息至共享信息服务系统方式时，需各数

.2章节中的相关描述说明。在本模式下，各数据提供方推送数据至前置交换区时，需要向各业务表的“时间戳”字段和“更新记录表”进行赋值。.5 FTP

文件上传模式规范采用各数据提供方通过

文件上传方式将自身数据库业务表数据信息传至共享信息服务系统参照

章节中的相关描述说明。各数据提供方将自身政务数据制作为数据文件上传至前置交换区指定

文件服务器上，共享信各业务表的“时间戳”字段和“更新记录表”进行赋值，上传至

文件服务器相关文件命名及格式需要遵循以下规范：a)

CSV、EXCEL、需要扩展支持其他类型格式；b)文件命统一命名为：“上传日期（YYYYMMDD）+数据库名称+文件名称”。 需求方规范.1 概述基于前置数据库交换模式，各数据提供方的相关政务数据集中存储在前置交换区内，因此，各数

换功能。.2 直接访问数据库

据，非原始业务数据，数据需求方无权查阅数据提供方的原始业务数据。.3 数据接口23DB4201/T

采用数据接口获取数据时，共享信息服务系统将查询数据功能封装为一个对外发布的

API

数据接口，数据需求方根据授权情况，调取该数据接口，具体规范要求详见

需求方数据接口章节描述说明。.4 FTP

文件导出采用

文件导出获取数据时，共享信息服务系统将查询出的数据组装制作成需求方指定文件格

文件支持

CSV、EXCEL、XML

三种格式，后续可根据实际需要扩展支持其他类型格式。7 数据资源交换管理规范7.1 概述7.1.1 数据资源交换体系管理架构包括数据资源交换体系使用和管理的三个角色和六项活动。三个角服务、使用。如图

使用规划服务开发

运维注册

图10数据资源交换体系总体管理架构7.1.2 数据提供方、管理者、数据需求方三方共同对数据资源共享交换体系进行规划、制定。数据提方有权查询发布的服务接口并访问调取相应的政务数据资源。7.2角色职责7.2.1 数据提供方数据提供方的管理职责包括：a) 负责本部门政务数据资源共享交换服务接口建设的规划；b) 负责开发服务接口具体实现功能；c) 整性、时效性；24DB4201/T

536.2—2017d)配合数据中心管理员调试服务接口功能。7.2.2 管理者管理者指数据中心管理员，其管理职责包括：a) 负责协调全市各行政主管部门完成政务数据资源共享交换服务接口建设方案；b) 为各提供方分配前置交换区；c) 对各行政主管部门的服务接口内容审核、发布；d) 配置、调试各提供方服务接口功能；e)配合需求方调试服务接口功能；f) 提供政务数据资源的访问、获取服务接口。7.2.3 数据需求方数据需求方的管理职责包括：a) 负责本部门各政务数据资源共享交换需求方案的规划；b) 访问调取在授权范围内的政务数据资源，实现数据交换功能；c) 保证查阅数据资源的保密性和安全性，不得违规将数据提供给第三方。7.3 管理环节7.3.1 管理环节与角色关系如图

所示，政务数据共享交换体系建设和管理各项活动与所涉及的角色关系如下：a) “规划”环节：由数据提供方、管理者、数据需求方共同完成；b) “开发”环节：由数据提供方、数据需求方各自完成；c) “注册”环节：由数据提供方完成；d) “运维”环节：由数据中心管理员完成；e) “服务”环节：由数据中心管理员完成；f) “使用”环节：由数据需求方完成。7.3.2 规划规划工作主要由数据提供方、管理者、数据需求方共同完成。该活动的主要内容包括：a) 方案；b) 管理者协调数据提供方、数据需求方制定政务数据资源共享交换方案；c) 各数据提供方、数据需求方制定政务数据资源共享交换服务接口建设计划。7.3.3 开发开发工作主要由数据提供方、数据需求方各自分别完成。该活动的主要内容包括：a) 实现政务数据资源对外共享功能；b) 数据提供方负责相关可共享交换数据资源的更新、上报维护。7.3.4 注册注册工作主要由数据提供方完成。该活动的主要内容包括：25DB4201/T

a) 数据提供方登记、注册政务数据资源共享交换服务的接口内容；b) 配合管理者配置、调试本部门服务接口功能。7.3.5 管理管理工作主要由管理者完成。该活动的主要内容包括：a)为各数据提供方分配前置交换区，创建业务表结构；b) 审核各数据提供方请求发布的服务接口功能；c) 配置调试各数据提供方服务接口功能；d) 审核各数据需求方对服务接口访问调取请求，分配相关权限，保证系统持续运行。7.3.6 服务服务工作主要由管理者完成。该活动的主要内容包括：a) 配合各数据需求方调试服务接口功能；b) 对外提供前置交换区数据访问接口功能。7.3.7 使用使用工作主要由数据需求方完成。该活动的主要内容包括：a) 查询定位各数据提供方对外提供的服务接口；b) 通过服务接口功能获取具体可共享政务数据资源业务信息。7.4 制度建设参照《武汉市政务数据资源共享管理暂行办法》和《武汉市政务云平台数据资源安全管理实施细则》中相关制度要求，保障政务服务及接口规范的持续运行，保证信息安全与系统持续安全服务。26政务数据共享交换申请单XXXXXXX提供方名称服务名称所需数据项调取说明提供方反馈意见XX数据需求方填表时间联系人电话DB4201/T

536.2—2017附 录 A（资料性附录）政务共享交换服务表单示例A.1 政务数据共享交换申请单示例政务数据共享交换申请单示例如表所示。表A.1 表A.1 政务数据共享交换申请单示例政务数据共享交换确认单XXXXXXXX-XX-XXXXXX-XX-XX数据需求部门数据提供部门市网信办审核意见：DB4201/T

A.2 政务数据共享交换确认单示例政务数据共享交换确认单示例如表所示。表A.2表A.2政务数据共享交换确认单示例提供方数据接口参数示例接口名称：getXxByIDCard接口版本号：X.X接口描述：

XX

接口类型：webservice返回报文类型：xml访问地址：http://WebServices/ValidateEmailWebService.asmx?wsdl访问帐号：XXXXX访问密码：XXXXXX提供方名称：XXX技术联系人：XX联系人电话：XXXXXXXXXXX请求参数名称类型数据长度是否必须默认值描述ID_cardString18

响应参数名称类型数据长度示例值描述NameString50XXPhoneString20XXXXXXXXXXX错误结果参数名称类型数据长度示例值描述CodeString50MsgString30Remote

serviceerrorsub_msgString100错误代码定义DB4201/T

536.2—2017B附

录 B（资料性附录）数据接口参数示例B.1 提供方数据接口参数示例表提供方数据接口参数示例如表所示。表B.1表B.1提供方数据接口参数示例表错误代码错误消息错误说明50Remote

service

error30illegal

20illegal

请求示例XML

<user_buyer_get_response>

</user_buyer_get_response>响应示例XML

<user_buyer_get_response>

</user_buyer_get_response>错误结果示例XML

<error_response>

</sub_msg></error_response>DB4201/T

表

B.1提供方数据接口参数示例表（续）30提供方数据接口参数示例接口名称：getPersonByIDCard接口版本号：X.X接口描述：

XX

接口类型：webservice返回报文类型：xml访问地址：http://localhost:9099/api/ws/rest技术联系人：XX联系人电话：XXXXXXXXXXX公共请求参数名称类型数据长度是否必须默认值描述methodString20api_keyString50

timestampString10

yyyy-MM-ddHH:mm:ss

String1.0signString2048请求参数名称类型数据长度是否必须默认值描述ID_cardString18

响应参数名称类型数据长度示例值描述NameString50XXPhoneString20XXXXXXXXXXX错误结果参数名称类型数据长度示例值描述codeString50msgString30Remote

serviceerrorsub_msgString100DB4201/T

536.2—2017B.2 调取所需数据接口参数示例表调取所需数据接口参数示例如表B.2所示。表B.2 表B.2 调取所需数据接口参数示例表错误代码定义错误代码错误消息错误说明50Remote

service

error30illegal

20illegal

请求示例XML

<user_buyer_get_response>

</user_buyer_get_response>响应示例XML

<user_buyer_get_response>

</user_buyer_get_response>错误结果示例XML

<error_response>

</sub_msg></error_response>DB4201/T

表

表

B.2 调取所需数据接口参数示例表（续）数据库配置参数示例提供方名称：XXX数据库名称：db_person数据库类型：Oracle数据库

IP

XXX.XXX.XXX.XXX端口：XXXX数据库

MAC

XXX.XXX.XXX.XXX用户名：XXXXX密码：XXXXXX技术联系人：XX联系人电话：XXXXXXXXXXX业务表信息名称说明更新频率当前记录数每周期更新数据量数据保存周期person