ICS 35.200 L 65 DB36 江 西 省 地 方 标 准 DB36/T 982—2017 网上审批系统数据接口规范 Specification for data interface of the online approval system 2017 - 12 - 29 发布 江西省质量技术监督局 2018 - 03 - 01 实施 发 布 DB36/T 982—2017 目 次 前言 ............................................................................... III 引言 ................................................................................. I 1 范围 .............................................................................. 1 2 术语和定义 ........................................................................ 1 3 接口主要功能 ...................................................................... 2 4 数据查询 .......................................................................... 2 5 数据交互 .......................................................................... 3 6 接口调用要求 ...................................................................... 4 附录 A（规范性附录） 查询类接口示例及说明 ............................................ 5 附录 B（规范性附录） 交互类接口示例及说明 ............................................ 7 附录 C（规范性附录） 政府部门业务专网系统前置数据库数据结构及说明 ................... 17 I DB36/T 982—2017 前 言 本标准按照GB/T 1.1-2009《标准化工作导则 第1部分：标准的结构和编写》的规定编写。 本标准由江西省发展和改革委员会提出并归口。 本标准主要起草单位：江西省信息中心、软件股份有限公司。 本标准主要起草人：金俊平、吴俐、孙杨、袁振武、陈兆亮、蔡亮、郑剑波、胡坚勇、郑自。 II DB36/T 982—2017 引 言 为进一步加强全省网上审批系统的规划、建设、运行、管理和服务，建立健全全省网上审批系统的 管理机制，推动网上审批系统建设规范有序发展，提升各级政府及其部门的社会管理和公共服务水平， 现根据国家、地方的相关文件要求和标准规范，结合我省网上审批业务现状和发展要求，制定本规范。 I DB36/T 982—2017 网上审批系统数据接口规范 1 范围 本标准规定了网上审批系统的数据接口规范，包括数据查询类和数据交互类两类接口标准规范。 本标准适用于省、市、县三级政务服务网及部门自建业务系统等第三方系统相关方开发、使用江西 省网上审批系统数据接口，以及相关政府部门自有系统对江西省网上审批系统及相关接口的管理。 2 术语和定义 下列术语和定义适用于本文件。 2.1 JSON java script object notation 一种轻量级的数据交换格式。基于 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编码(URL encoding)，也称作百分号编码 (Percent-encoding)，是特定上下文的统一资源定位符 (URL)的编码机制。适用于统一资源标识符(URI) 的编码，也用于为"application/x-www-form-urlencoded" MIME准备数据,因为它用于通过HTTP的请求 操作(request)提交HTML表单数据。 2.4 电子政务外网 1 DB36/T 982—2017 政府的业务专网，主要运行政务部门面向社会的专业性业务和不需要在内网上运行的业务，与互联 网之间逻辑隔离。 2.5 江西省网上审批系统 全省统一的集信息公开、网上办理、便民服务、电子监察于一体的网上审批系统，实现行政审批事 项统一网上受理、统一网上反馈、统一效能监察。实现非涉密行政审批事项全流程网上办理、并联审批、 信息共享、业务协同和即时电子监察，推进政务公开、规范权力运行、提升行政效能。 3 接口主要功能 江西省网上审批系统数据接口应包括但不限于以下功能： a) 数据查询； b) 数据交互； 4 数据查询 4.1 总则 系统提供完善的数据查询接口，满足不同应用场景的数据查询要求，为增加调用接口返回数据的易 读性，统一格式为标准JSON格式，以保障系统间正常数据抓取。 4.2 接口名称 1、获取系统办件公示； 2、获取办件统计数据； 3、根据申办编号，获取办理信息； 4、获取表单信息。 4.3 调用流程 数据查询应能实现对外的数据共享。接口接入方按照不同查询场景传入格式参数获取指定信息。如 图1所示 1、应用接入方按照业务查询场景组装查询参数并发送查询请求； 2、系统接受查询请求后解析相关参数，按查询场景返回相关数据； 3、将返回信息组装编码后返回。 2 DB36/T 982—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/T 982—2017 图 2 交互类接口调用流程 6 接口调用要求 6.1 接口类型、传输协议 系统为REST接口，对外仅支持http数据传输协议。 6.2 网络环境 系统接口部署于江西省电子政务外网，应确保外部调用方与江西省网上审批系统应用服务器之间能 互联互通。 6.3 返回数据编码 返回信息使用UrlEncode编码，接收后需解码。 4 DB36/T 982—2017 附 录 A （规范性附录） 查询类接口示例及说明 A.1 获取办件公示接口 表1 获取办件公示接口表 服务名称 http://10.65.8.195: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/T 982—2017 备注 返回信息使用了 urlencode 加密（uft-8） A.3 获取办理信息接口 表3 根据申办编号，获取办理信息接口表 服务名称 web/jxapproval/getBusinessInfo 服务