国资数智化 第 2 部分：数据接口规范.docx

ICS03.100.01A02

DB13

河北省地方标准

DB13/TXXXX—XXXX

国资数智化第2部分：数据接口规范

XXXX-XX-XX发布XXXX-XX-XX实施

河北省市场监督管理局发布

I

DB13/TXXXX—XXXX

目次

前言 II

1范围 1

2规范性引用文件 1

3术语和定义 1

4交换方式 1

5交换接口 2

参考文献 8

II

DB13/TXXXX—XXXX

前言

本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。

本文件由河北省人民政府国有资产监督管理委员会提出并归口。

本文件起草单位：河北省人民政府国有资产监督管理委员会信息中心、河钢数字技术股份有限公司、河北省标准化研究院。

本文件主要起草人：XXX。

1

DB13/TXXXX—XXXX

国资数智化第2部分：数据接口规范

1范围

本文件规定了国资数据交换方式和交换接口的要求。

本文件适用于国资“数智化”管理系统的建设、运营、维护等。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其必威体育精装版版本（包括所有的修改单）适用于本文件。

GB/T5271.1信息技术词汇第1部分：基本术语

GB/T41138产品质量信息系统信息分类与共享交换

3术语和定义

GB/T5271.1、GB/T41138界定的术语和定义适用于本文件。

3.1

共享交换sharingandexchange

通过数据的采集、处理、存储和应用等过程活动在不同方之间传递数据，一定条件下实现各方交流和共用数据。

[来源：GB/T41138-2021，3.3.3]

3.2

接口界面interface

两个功能单元共享的边界,它由各种特征(如功能、物理互连、信号交换等)来定义。[来源：GB/T5271.1-2000，01.01.38]

4交换方式

4.1共享交换方式

国资数据共享交换方式分为外部数据共享交换和内部数据共享交换两种：

a)外部数据共享交换：依托省级信息资源共享交换平台实现，主要是与同级部门间的数据交换共享，参与数据交换的各业务部门通过API接口与信息资源交换共享平台进行连接，获取其他部门的数据，与第三方数据主要通过API接口实现，通过定时任务，定时获取第三方接口提供的数据，并与本地数据进行比对，将必威体育精装版数据进行持久化操作；

2

DB13/TXXXX—XXXX

b)内部数据共享交换：通过API接口实现与国资委各业务部门之间的数据共享交换。数据共享交换范围依据国资委相关要求进行提供。

4.2实现形式

数据共享采用基于Rest的同步请求数据交换接口的形式实现。

4.3通用要求

4.3.1数据内容

内部共享交换数据包含（但不限于）：国资国企基本信息、组织机构信息、“三重一大信息”、产权信息、投资信息等。

外部共享交换数据包含（但不限于）：产权信息、投资信息等。

4.3.2交换记录项

每条数据记录在交换时需要增加设置记录ID(GUID)、记录入库时间、记录出库时间这三个用于交换的数据项。其中，记录ID为数据记录指纹，由数据生成单位赋值，采用GUID机制，以标识记录的全局唯一性。

4.3.3交换数据

在数据交换中，汉字使用中文半角，英文字母、数字和符号使用英文半角。除正式交换数据外，禁止在任何其他位置输入其他文字。交换数据采用UTF-8编码格式。

4.3.4传输网络

省属监管企业使用专线接入，市级国资监管机构以及市属企业，县级国资监管机构以及县属企业使用政务云网络。

5交换接口

5.1触发采集服务器拉取接口

拉取接口是由业务系统有需要上报数据时触发国资委采集服务器拉取接口。接口要求见表1。表1触发采集服务器拉取接口

调用频率

1次/5min

请求方式

POST

表1触发采集服务器拉取接口（续）

传参格式

JSON字符编码采用UTF-8

请求路径

http://ip:port/api/DataInterface/pullingInterfacePost

请求参数

参数名

类型

必填

说明

key

string

是

接口Key

sysName

string

是

系统名称（按外部数据源创建）

3

DB13/TXXXX—XXX