国资国企在线监管系统数据采集系统数据交换平台SM2 SM4 数字信封开发经验

一、 文档说明 ................................ ......... 1 1
二、 接口概述 ................................ ......... 2 2
三、 数据报送接口 ................................ ..... 3 3
（一） 接口说明 ............................................... 3
（二） 调用地址 ............................................... 3
（三） 服务请求信息 ........................................... 3
（四） 服务响应信息 ........................................... 4
（五） FTP 方式和网闸模式 ...................................... 4
四、 数据采集模板接口................................. . 5 5
（一） 接口说明 ............................................... 5
（二） 调用地址 ............................................... 5
（三） 服务请求信息 ........................................... 5
（四） 服务响应信息 ........................................... 6
（五） 网闸模式 ............................................... 7
五、 接受下发通知公告数据接口 ......................... 8 8
（一） 接口说明 ............................................... 8
（二） 调用地址 ............................................... 8
（三） 服务请求信息 ........................................... 8
（四） 服务响应信息 ........................................... 9
（五） 网闸模式 .............................................. 11
六、 数据日志接口 ................................ .... 12
（一） 接口说明 .............................................. 12
（二） 调用地址 .............................................. 12
（三） 服务请求信息 .......................................... 12
（四） 服务响应信息 .......................................... 13
（五） 网闸模式 .............................................. 15
1
一、 文档说明
按照《国资国企在线监管系统建设实施方
案》（以下简称《实施方案》）要求，省国资委出资企业应
遵循国资委指定的数据采集交换相关数据标准、
接口规范等统一要求，建设本单位数据采集交换平台，作
为与国资国企在线监管系统数据采集系统的对口
平台。
根据上述要求，本文档对相关接口规范进行了详细说
明，以指导各地（市）国资监管机构、省国资委出资企业
在建设本单位国资监管数据交换平台时，做好相应接口开
发对接工作。
2
二、 接口概述
数据接口是国资委全国国资国企在线监管系
统对省国资委出资企业实现实时动态采集的主要信息交换
手段。需要结合信息安全相关要求，通过文件摆渡方式，
由，省国资委出资企业调用使用，本文档中主要说明的接
口包括以下 4 类：
（一）数据报送接口。
（二）数据采集模板接口。
（三）接受下发通知公告数据接口。
（四）数据日志接口。
3
三、 数据报送接口
（一） （一） 接口说明 接口说明
省国资委出资企业内网的数据报送系统向前置服务器
报送数据文件（加密的 ZIP 文件）的上传接口。
（二） （二） 调用地址 调用地址
http://前置服务器 IP 地址:9000/services/fileUpload
（三） （三） 服务请求信息 服务请求信息
请求参数体（request body）
参数名 类型 必填 参数位置 描述 默认值
无 File 是 Http Body
ZIP 格式的报送数据
文件
无
USER String 是 Request Url
调用接口用户名：
1.调用本接口时，接
口对传入用户名、密
码进行校验，若与本
接口提供的调用用户
名、密码一致时，才
接受文件。
2.若用户名、密码不
一致不接收文件，并
在返回响应参数体中
serviceFlag 标识为
没有权限，告之访问
方。
无
PASSWORD String 是 Request Url
调用接口密码：
1. 调用本接口时，
接口对传入用户名、
密码进行校验，若与
本接口提供的调用用
户名、密码一致时，
无
4
参数名 类型 必填 参数位置 描述 默认值
才接受文件。
2. 若用户名、密码
不一致不接收文件，
并在返回响应参数体
中 serviceFlag 标识
为没有权限，告之访
问方。
（四） （四） 服务响应信息 服务响应信息
1. 1. 响应参数头（ 响应参数头（ response header ）
（1）Access-Control-Allow-Origin：*
（2）Access-Control-Allow-Methods：POST,GET,OPTION
（3）Content-type：application/json; charset=UTF-8
2. 2. 响应参数体（ 响应参数体（ response body ）
（1）返回值为 JSON 对象
（2）示例：{“serviceFlag”:“1”，“msg”:“报
送文件接口:文件接收成功”}
参数名 类型
节点位置( ( 父节点名
称) )
描述
serviceFlag String {}
0：代表失败。
1：成功。
2：没有权限。
msg String {} 上传结果详细描述
（五） （五） FTP FTP 方式和网闸模式
使用 FTP 方式或者网闸报送文件时：将 zip 文件上传
至前置机指定目录：(Windows 为 D 盘、Linux 为根)/省国
5
资委出资企业 18 位统一社会信用代码/业务编码/目录下。
四、 数据采集 模板 接口
（一） （一） 接口说明 接口说明
省国资委出资企业内网的数据报送系统在前置服务器
获取数据采集资源表、指标项等相关模板文件（加密 ZIP
文件）等的下载接口。
该接口文件为全量数据采集模板的更新文件，只保留
最新版本的文件。根据接口地址，可以获取最新的数据采
集模板文件。对于一直未下载的文件，当国资委发布最新
文件时，会将覆盖旧文件，只保留最新版待省国资委出资
企业端获取。
（二） （二） 调用地址 调用地址
http://前置服务器 IP 地址:9000/services/temp Download
（三） （三） 服务请求信息 服务请求信息
请求参数体（request body）
参数名 类型 必填 参数位置 描述 默认值
BUSTYPE String 是 Requesl Url 无
USER String 是 Request Url
调用接口用户名：
1、调用本接口时，
接口对传入用户名、
密码进行校验，若与
本接口提供的调用用
无
6
参数名 类型 必填 参数位置 描述 默认值
户名、密码一致时，
才接受文件;
2、若用户名、密码
不一致不接收文件，
并在返回响应参数体
中 serviceFlag 标识
为没有权限，告之访
问方;
PASSWORD String 是 Request Url
调用接口密码：
1、调用本接口时，
接口对传入用户名、
密码进行校验，若与
本接口提供的调用用
户名、密码一致时，
才接受文件;
2、若用户名、密码
不一致不接收文件，
并在返回响应参数体
中
serviceFlag 标识为
没有权限，告之访问
方;
无
（四） （四） 服务响应信息 服务响应信息
1. 1. 下载失败或无文件时返回 下载失败或无文件时返回 N JSON 对象
（1）响应参数头（response header）
Access-Control-Allow-Origin：*
Access-Control-Allow-Methods：POST,GET,OPTION
Content-type：application/json; charset=UTF-8
（2）响应参数体（response body）
返回值为 JSON 对象。
示例：{“serviceFlag”:“1”,“msg”:“下载接
7
口:没有新文件”}
参数名 类型
节点位置( ( 父节点名
称) )
描述
serviceFlag String {}
0：代表失败;
1：无新文件;
2：没有权限;
msg String {} 下载结果详细描述
2. 2. 下载成功时返回文件 下载成功时返回文件
（1）响应参数头（response header）
Content-Disposition：attachment;filename="filename"
Content-type：text/plain;charset=utf-8
（2）响应参数体（response body）
参数名 类型 文件格式 描述
无 file ZIP
返回模板相关数据打包后
的 ZIP 文件
（3）文件信息说明
ZIP 文件中包含加密的 DB 文件。
（4）文件命名规则
ZIP 文件命名规则为：省国资委出资企业统一社会信用
代码_模块编码_业务编码_版本号_时间戳_UUID.zip。
xxxxxxxxxxxxxxxxxx_TEMP_0001_1000_yyyyMMddHHmms
s_UUID.zip
（五） （五） 网闸模式 网闸模式
使用网闸时，当省国资委将文件下发到前置服务器对应
目录，会默认为省国资委出资企业已经将文件摆渡，日志记
8
录会将下发时间和下载时间同时赋值为当前时间。下载目录
为：(Windows 为 D 盘、Linux 为根)/省国资委出资企业 18 位
统一社会信用代码/dataexchange/tempfile/。
五、 接受下发 通知公告 数据接口
（一） （一） 接口说明 接口说明
省国资委出资企业内网的数据报送系统在前置服务器
获取通知公告文件（ZIP 文件）的下载接口。
该接口文件为增量更新文件，对于补传任务同一业务
会有多个补传任务，所有下发的文件都会保留。省国资委
出资企业端请求接口时需要轮循调用获取所有文件，直至
响应头为 application/json; charset=UTF-8（异常或无文
件）。
（二） （二） 调用地址 调用地址
http://前置服务器 IP 地址:9000/services/noticeDownload
（三） （三） 服务请求信息 服务请求信息
请求参数体（request body）
参数名 类型 必填 参数位置 描述 默认值
USER String 是 Request Url
调用接口用户名：
1、调用本接口时，接口
对传入用户名、密码进
行校验，若与本接口提
无
9
参数名 类型 必填 参数位置 描述 默认值
供的调用用户名、密码
一致时，才接受文件;
2、若用户名、密码不一
致不接收文件，并在返
回响应参数体中
serviceFlag 标识为没
有权限，告之访问方;
PASSWORD String 是 Request Url
调用接口密码：
1、调用本接口时，接口
对传入用户名、密码进
行校验，若与本接口提
供的调用用户名、密码
一致时，才接受文件;
2、若用户名、密码不一
致不接收文件，并在返
回响应参数体中
serviceFlag 标识为没
有权限，告之访问方;
无
（四） （四） 服务响应信息 服务响应信息
1. 1. 下载失败或无文件时返回 下载失败或无文件时返回 N JSON 对象
（1）响应参数头（response header）
Access-Control-Allow-Origin：*
Access-Control-Allow-Methods：POST,GET,OPTION
Content-type：application/json; charset=UTF-8
（2）响应参数体（response body）。
返回值为 JSON 对象
示例：{“serviceFlag”:“2”,“msg”:“下载接
口:用户名密码错误”}
参数名 类型
节点位置( ( 父节点名
称) )
描述
serviceFlag String {} 0：代表失败;
10
1：无新文件;
2：没有权限;
msg String {} 下载结果详细描述
2. 2. 下载成功时返回文件 下载成功时返回文件
（1）响应参数头（response header）
Content-Disposition：attachment;filename="filename"
Content-type：text/plain;charset=utf-8
（2）响应参数体（response body）
参数名 类型 文件格式 描述
无 file ZIP
返回通知公告相关数据打
包后的 ZIP 文件
（3）文件信息说明
ZIP 文件中包含一个数据的 XML 文件（内容为通知公告
表相关数据，与前述 XML 文件作用类似）、多个相关附件。
ZIP 文件命名规则：省国资委出资企业统一社会信用代
码_模块编码_时间戳_UUID.zip
xxxxxxxxxxxxxxxxxx_NOTICE_yyyyMMddHHmmss_UUID.z
ip
数据 XML 文件命名为：NOTICE_DATA.xml
附件名称为省国资委下发原始文件名。
11
省国资委出资企业应将 ZIP 文件解压，将 XML 数据解
析入库，将附件自行存储关联。入库前先根据主键 ID 进行
查询，如果有则覆盖，没有则添加。
通知公告分类：目前 0007 为异常反馈通知、0009 为普
通通知，根据下发的 NOTIDE_DATA.xml 文件中的权限编码
来区分通知的权限。
（五） （五） 网闸模式 网闸模式
使用网闸时，当省国资委将文件下发到前置服务器对应
目录，会默认为省国资委出资企业已经将文件摆渡，日志记
录会将下发时间和下载时间同时赋值为当前时间。该接口文
件为增量更新文件，对于补传任务同一业务会有多个补传任
12
务，所有下发的文件都会保留。下载目录为：(Windows 为 D
盘、Linux 为根)/省国资委出资企业 18 位统一社会信用代码
/dataexchange/ notice file/。
六、 数据日志接口
（一） （一） 接口说明 接口说明
省国资委出资企业内网的数据报送系统在前置服务器
同步数据文件报送日志记录的下载接口。
（二） （二） 调用地址 调用地址
http://前置服务器 IP 地址:9000/services/logDownload
（三） （三） 服务请求信息 服务请求信息
请求参数体（request body）
参数名 类型必填 参数位置 描述 默认值
STARTDATE String 是
Request
Url
时间区间开始值;
格式：yyyyMMdd;
（定时任务不需要）。
时间区间不可超过 1
个自然月的天数。
无
ENDDATE String 是
Request
Url
时间区间结束值;
格式：yyyyMMdd;
（定时任务不需要）。
时间区间不可超过 1
个自然月的天数。
无
SIDE String 是
Request
Url
表示省国资委出资企
业内网数据动态监测
采集服务器：
ENTERPRISE
无
13
参数名 类型必填 参数位置 描述 默认值
（定时任务为：
ETIMED）
USER String 是
Request
Url
调用接口用户名:
1、调用本接口时，接
口对传入用户名、密
码进行校验，若与本
接口提供的调用用户
名、密码一致时，才
接受文件;
2、若用户名、密码不
一致不接收文件，并
在返回响应参数体中
serviceFlag 标识为没
有权限，告之访问方;
无
PASSWORD String 是
Request
Url
调用接口密码:
1、调用本接口时，接
口对传入用户名、密
码进行校验，若与本
接口提供的调用用户
名、密码一致时，才
接受文件;
2、若用户名、密码不
一致不接收文件，并
在返回响应参数体中
serviceFlag 标识为没
有权限，告之访问方;
无
（四） （四） 服务响应信息 服务响应信息
1. 1. 响应参数头（ 响应参数头（ response header ）
Access-Control-Allow-Origin：*
Access-Control-Allow-Methods：POST,GET,OPTION
Content-type：application/json; charset=UTF-8
14
2. 2. 响应参数体（ 响应参数体（ response body ）
返回值为 JSON 串
示例：{“serviceFlag”:“3”,“msg”:“日志下载
接口:获取到对应时间的日志”,“logList”:“日志数据
的 JsonArray 数组”}
参数名 类型
节点位置( ( 父
节点名称) )
描述
serviceFlag String {}
0：代表失败;
1：无新日志;
2：没有权限;
3：有新日志;
如果为 3 请通过 key 为 logList
的 JsonArray 数组获取日志数
据
msg String {} 日志下载结果详细描述
logList JsonArray {} 日志数据的 JsonArray 数组
3. 3. 日志数据内容说明。 日志数据内容说明。
JSON 数组中的每个 JSON 串为一条日志记录，可以将记
录入库储存并通过页面进行展示。
示例:
数据结构
参数名 类型
节点位置( ( 父节点
名称) )
描述
15
el_id String [{}] 日志主键 ID
business_code String [{}] 业务编码
file_name String [{}] 报送文件名称
push_date String [{}] 推送时间
grab_date String [{}] 抓取时间
repair_mark String [{}]
补录标识
1、正常上传为 1
2、主动补录为 0
3、被动补录为补录任务
的主键 ID
el_createdate String [{}] 日志生成时间
（五） （五） 网闸模式 网闸模式
使用网闸时，当文件被省国资委抓取后，该记录会生成
对应的 xml 文件于(Windows 为 D 盘、Linux 为根)/省国资委
出 资 企 业 18 位 统 一 社 会 信 用 代 码
/dataexchange/datapushlog/。
私信qq   874689017