DB36/T 982-2017 网上审批系统数据接口规范

ICS35.200

L65

DB36

江西省地方标准

DB36/T982—2017

网上审批系统数据接口规范

Specificationfordatainterfaceoftheonlineapprovalsystem

2017-12-29发布2018-03-01实施

江西省质量技术监督局发布

DB36/T982—2017

目次

前言...............................................................................III

引言.................................................................................I

1范围..............................................................................1

2术语和定义........................................................................1

3接口主要功能......................................................................2

4数据查询..........................................................................2

5数据交互..........................................................................3

6接口调用要求......................................................................4

附录A（规范性附录）查询类接口示例及说明............................................5

附录B（规范性附录）交互类接口示例及说明............................................7

附录C（规范性附录）政府部门业务专网系统前置数据库数据结构及说明...................17

I

DB36/T982—2017

前言

本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》的规定编写。

本标准由江西省发展和改革委员会提出并归口。

本标准主要起草单位：江西省信息中心、软件股份有限公司。

本标准主要起草人：金俊平、吴俐、孙杨、袁振武、陈兆亮、蔡亮、郑剑波、胡坚勇、郑自。

II

DB36/T982—2017

引言

为进一步加强全省网上审批系统的规划、建设、运行、管理和服务，建立健全全省网上审批系统的

管理机制，推动网上审批系统建设规范有序发展，提升各级政府及其部门的社会管理和公共服务水平，

现根据国家、地方的相关文件要求和标准规范，结合我省网上审批业务现状和发展要求，制定本规范。

I

DB36/T982—2017

网上审批系统数据接口规范

1范围

本标准规定了网上审批系统的数据接口规范，包括数据查询类和数据交互类两类接口标准规范。

本标准适用于省、市、县三级政务服务网及部门自建业务系统等第三方系统相关方开发、使用江西

省网上审批系统数据接口，以及相关政府部门自有系统对江西省网上审批系统及相关接口的管理。

2术语和定义

下列术语和定义适用于本文件。

2.1

JSONjavascriptobjectnotation

一种轻量级的数据交换格式。基于ECMAScript(w3c制定的js规范)的一个子集，采用完全独立于编

程语言的文本格式来存储和表示数据。

2.2

HTTP传输协议

标准超文本传输协议。使用对参数进行编码并将参数作为键值对传递，还使用关联的请求语义。每

个协议都包含一系列HTTP请求标头及其他一些信息，定义客户端向服务器请求哪些内容，服务器用一系

列HTTP响应标头和所请求的数据进行响应。HTTP-GET使用MIME类型

application/x-www-form-urlencoded（将追加到处理请求的服务器的URL中）以URL编码文本的形

式传递其参数。URL编码是一种字符编码形式，可确保传递的参数中包含一致性文本，例如将空格编码

为%20，其它符号转换为%XX,其中XX为该符号以16进制表示的ASCII（或ISOLatin-1）值。追加的参数也

称为查询字符串;HTTP-POST参数也是URL编码的，但是，键/值对是在实际的HTTP请求消息内部传递

的，而不是作为URL的一部分进行传递。

2.3

UrlEncode

一个函数，可将字符串以URL编码，用于编码处理。URL编码(URLencoding)，也称作百分号编码

(Percent-encoding)，是特定上下文的统一资源定位符(URL)的编码机制。适用于统一资源标识符(URI)

的编码，也用于为"application/x-www-form-urlencoded"MIME准备数据,因为它用于通过HTTP的请求

操作(request)提交HTML表单数据。

2.4

电子政务外网

1

DB36/T982—2017

政府的业务专网，主要运行政务部门面向社会的专业性业务和不需要在内网上运行的业务，与互联

网之间逻辑隔离。

2.5

江西省网上审批系统

全省统一的集信息公开、网上办理、便民服务、电子监察于一体的网上审批系统，实现行政审批事

项统一网上受理、统一网上反馈、统一效能监察。实现非涉密行政审批事项全流程网上办理、并联审批、

信息共享、业务协同和即时电子监察，推进政务公开、规范权力运行、提升行政效能。

3接口主要功能

江西省网上审批系统数据接口应包括但不限于以下功能：

a)数据查询；

b)数据交互；

4数据查询

4.1总则

系统提供完善的数据查询接口，满足不同应用场景的数据查询要求，为增加调用接口返回数据的易

读性，统一格式为标准JSON格式，以保障系统间正常数据抓取。

4.2接口名称

1、获取系统办件公示；

2、获取办件统计数据；

3、根据申办编号，获取办理信息；

4、获取表单信息。

4.3调用流程

数据查询应能实现对外的数据共享。接口接入方按照不同查询场景传入格式参数获取指定信息。如

图1所示

1、应用接入方按照业务查询场景组装查询参数并发送查询请求；

2、系统接受查询请求后解析相关参数，按查询场景返回相关数据；

3、将返回信息组装编码后返回。

2

DB36/T982—2017

图1查询类接口调用流程

5数据交互

5.1接口名称

1、保存表单项；

2、外部（政务服务网）业务申报；

3、外部业务（第三方业务系统所涉及的业务）转存政府部门业务专网系统前置数据库。

5.2调用流程

数据交互实现外部接入方和系统的数据交互，实现完整的网上审批业务申报逻辑。如图2所示。

1、外部应用接入方按照事项唯一标识组装查询参数获取申请表单（见下图2①）；

2、表单填入后组装表单保存的报文，调用表单保存接口（见下图2②）；

3、系统接受程序解析表单保存报文，返回保存结果：申办编号；

4、调用网盘上传逻辑（见下图2③）；

5、组装业务申请报文调用申报接口（见下图2④）；

6、系统接受程序解析申请报文，界定事项办理地址，是否需要进行业务转发（见下图2⑤），外

部业务转存政府部门业务专网系统前置数据库（见下图2⑥）；

7、组装业务的基础信息、表单信息、材料信息，返回保存结果（见下图2⑦）。

3

DB36/T982—2017

图2交互类接口调用流程

6接口调用要求

6.1接口类型、传输协议

系统为REST接口，对外仅支持http数据传输协议。

6.2网络环境

系统接口部署于江西省电子政务外网，应确保外部调用方与江西省网上审批系统应用服务器之间能

互联互通。

6.3返回数据编码

返回信息使用UrlEncode编码，接收后需解码。

4

DB36/T982—2017

附录A

（规范性附录）

查询类接口示例及说明

A.1获取办件公示接口

表1获取办件公示接口表

服务名称95:8091/web/jxapproval/getBusinessListInfo

服务说明获取网上审批系统最新的50条业务

请求方式GET

参数参数说明

参数列表orgCode可不传

regionCode固定传入360521000000

{"info":[{"RECEIVE_NUMBER":受理编号

"FINISH_TIME":办结时间有值代表已办

结,"ACCEPT_USER_NAME":"受理用户名称","APPLICANT":"申报单

位名称","APPLY_SUBJECT":"业务主题

返回值

","CURRENT_NODE_NAME":"当前环节名称","ITEM_NAME":"是想

名称","ORG_NAME":"单位名称","RECEIVE_NUMBER":"收件编号-

对应的业务查询","SUBMIT_TIME":提交时间,"TIME_LIMIT":承诺期

限}],"state":"200"}

备注返回信息使用了urlencode加密（uft-8）

A.2获取办件统计数据接口

表2获取办件统计数据接口表

服务名称web/jxapproval/getStatistics

服务说明获取网上审批系统获取统计数据

请求方式GET

参数名称参数说明

参数列表

orgCode部门编码

{"info":[{"ALLACCEPT":受理总数,"ALLFINISH":办结总

返回值数,"MONTHACCEPT":月受理数,"MONTHFINISH":月办结

数}],"state":"200"}

5

DB36/T982—2017

备注返回信息使用了urlencode加密（uft-8）

A.3获取办理信息接口

表3根据申办编号，获取办理信息接口表

服务名称web/jxapproval/getBusinessInfo

服务说明根据申办编号，获取办理信息

请求方式GET

参数名称参数说明

参数列表

receiveNumber申办编号

{

"state":"200",

"error":"错误信息",

"info":[

{

"RECEIVE_NUMBER":"10134110201411280117",//受理编号

"BSNUM":370100000000-351100-XK-1417158418717-1862",//业务实

例号

"CURRENT_NODE_ID":

"sid-7AEF96EA-7ACC-4EF2-8A3B-6686850018DB",//业务当前环节编

号

"CURRENT_NODE_NAME":"KL3-2",//业务当前环节名称

返回值

"LIMIT_TIME":1417536000000,//步骤承诺时间"RECEIVE_TIME":

1417158605000,//接收时间

"SEND_TIME":1417158605000,//提交时间

"STATUS":"01",//运转状态取值业务实例状态目录

"USER_CODE":"41D2DB1E914C4D38911AFF5D1865F2BC",//审批人

工号

"USER_NAME":"通用审批管理员",//审批人姓名"WARNING_TIME":

1417449600000//步骤预警时间

“OPINION”:办理

}

]

}

A.4获取表单信息接口

6

DB36/T982—2017

表4获取表单信息接口表

接口访问地址：web/jxapproval/getFormInfo

参数名类型说明备注

itemIdstring事项id事项id

返回结果：{

"info":{

"formId":表单id,

"formName":表单名称,

"objectType":"1,2,3"

},

"state":"200"

}

AA

7

DB36/T982—2017

BB

附录B