DB35/T 1789-2018 质量监督信息资源数据交换接口规范

ICS35.240

L67

DB35

福建省地方标准

DB35/T1789—2018

质量监督信息资源数据交换接口规范

Specificationfordataexchangeinterfaceofqualitysupervisioninformationresources

2018-09-11发布2018-12-11实施

福建省质量技术监督局发布

DB35/T1789—2018

目次

前言..............................................................................II

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

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4缩略语............................................................................1

5数据交换模式......................................................................2

6数据指标项........................................................................2

7数据交换接口......................................................................3

附录A（规范性附录）数据指标项......................................................8

附录B（资料性附录）接口身份认证格式样例...........................................16

附录C（资料性附录）数据接口模型封装数据格式样例...................................17

I

DB35/T1789—2018

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由福建省质量技术监督局行政服务中心提出。

本标准由福建省质量技术监督局归口。

本标准起草单位：福建省质量技术监督局行政服务中心、福建省经济信息中心。

本标准主要起草人：谢丹、陈绍林、徐侃、郑开新、魏祯、游鄂平、林钟。

II

DB35/T1789—2018

质量监督信息资源数据交换接口规范

1范围

本标准规定了省质量监督信息资源数据交换术语和定义、缩略语、数据交换模式、数据指标项以及

数据交换接口。

本标准适用于省质量监督信息资源数据交换。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB/T18391.1信息技术元数据注册系统(MDR)第1部分：框架

3术语和定义

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

3.1

数据交换dataexchange

各类实体之间相互提供数据的过程。

[GB/T36107-2018,定义3.1]

3.2

质量监督信息资源qualitysupervisioninformationresources

省质监系统各单位及其他有关单位、部门在实现质量安全监管控制过程中，采用文字和符号形式存

储在一定载体（包括文件、资料、图表、网页、数据等）之上的，可供利用的全部信息的总称。

3.3

质量监督信息资源数据交换平台qualitysupervisioninformationresourcesdataexchange

platform

通过计算机网络在若干个信息系统之间实现质量监督信息资源数据的抽取、转换、集中、加载、展

现等数据交换操作的信息系统。

4缩略语

下列缩略语适用于本文件。

URL统一资源定位符（UniformResourceLocator）

XML可扩展标记语言（ExtensibleMarkupLanguage）

1

DB35/T1789—2018

5数据交换模式

5.1总体框架

采用WebService技术，通过HTTP/HTTPS传输方式，由质量监督信息资源数据交换平台提供统一接

口标准，实现跨平台的数据交换。

5.2交换模式

质量监督信息资源数据交换平台对接口调用方发送的数据交换请求进行响应，身份验证成功后，将

需要交换的数据按XML格式进行封装，XML文件以UTF-8编码格式编写。

接口调用方可通过接口返回值状态码确认接口调用结果。返回值状态码见表1。

表1返回值状态码表

编码值描述

00执行成功

11执行失败

12用户名或密码错误

13参数不正确

14用户权限不足

15字段不存在

16请求类型不存在

99其他原因

6数据指标项

6.1数据指标项属性

描述一个数据指标项的属性包括：

——编号（DataNumber）：指标项的唯一编号，其格式为4位数字；

——标识（DataID）：指标项的标识；

——名称（DataName）：指标项的中文名称；

——数据类型（DataType）：指标项存放的数据类型与数据长度；

——约束（DataConstraint)：指标项的数据约束。

6.2数据指标项数据类型

数据指标项的数据类型定义见表2。

2

DB35/T1789—2018

表2数据类型表

字符含义

通过字符形式表达的值的类型。C后加自然数表示定长字符串，如C6表示6个定长字符（一

C

个汉字相当于两个字符）。

通过可计算的十进制形式表达的值的类型。N后加自然数表示定长数值，如N4表示4位定

N

长数字。

CN包括字符型和十进制数字，CN后加自然数表示定长数值，如CN5表示5个字符和/或数字。

日期型，通过YYYYMMDD形式表达的值的类型，符合GB/T7408的规范。用D后加4、6、8

D

分别表示不同数据格式的日期型数据元素。D4表示YYYY；D6表示YYYYMM；D8表示YYYYMMDD。

..UL表示长度不定的文本。

从最小长度到最大长度，前面附加最小长度，后面附加最大长度（也可以只附加最大长

..

度）。如C..6表示最多6个字符；N2..7表示最少2位数字最多7位数字。

6.3数据指标项内容

数据指标项内容见附录A。

7数据交换接口

7.1数据安全

身份认证：通过调用WebService方法，在数据交换报文头中增加身份认证消息报文，实现对接口

调用方的身份认证。接口身份认证XML文件详细格式参见附录B。

授权控制：接口调用方根据授权的数据权限进行数据调用。

数据加密：数据传输前须通过国密SM2算法对生成的XML信息进行加密。

7.2接口调用

通过HTTP请求格式调用服务将请求参数包含在请求的URL中，调用成功后，以XML格式返回结果，失

败时返回相应的错误信息。

7.3接口定义格式

接口应满足以下要求，具体内容要根据数据类型和实际部署情况进行修改：

接口类型：WebService（SOAP或REST风格）；

接口地址：http://[host]:[port]/[context]，包括：

[host]：系统IP地址；

[port]：系统访问端口号；

[context]：功能接口名称。主要包括接口名、参数、参数之间用&隔开。

7.4数据交换接口模型

7.4.1模型结构

3

DB35/T1789—2018

数据接口模型用于数据交换时封装交换信息，支持结构化数据和非结构化数据的封装。

数据接口模型由数据头、数据集、附件集组成。

结构如图1所示。

图1数据接口模型结构

数据接口模型封装数据的XML文件详细格式参见附录C。

7.4.2数据头

数据头结构

数据头由信息资源标识、信息资源名称、信息资源注释、请求操作、数据单元、扩展属性6个元素

组成。

结构如图2所示。

图2数据头的数据结构

信息资源标识

XML元素名称：ResourceID。

说明：交换信息的标识符，采用GB/T18391.1中对标识符的相关规定，用于标明业务类型。调用接

口时，通过不同的标识，对不同信息资源数据进行操作。

信息资源名称

XML元素名称：ResourceName。

说明：信息资源的名称。

信息资源名称和信息资源标识对照表见表3。

4

DB35/T1789—2018

表3信息资源标识和名称对照表

信息资源名称信息资源标识

企业信息00

行政许可信息01

地理标志产品信息02

企业产品标准备案信息03

地方标准题录信息04

强制性产品认证信息05

政府质量奖信息06

名牌产品信息07

标准贡献奖信息08

标准化良好行为信息09

产品质量监督抽查（合格）信息10

产品质量监督抽查（不合格）信息11

行政处罚信息12

特种设备使用登记及检验信息13

计量器具信息14

信息资源注释

XML元素名称：ResourceDcrp。

说明：对信息资源的解释性描述，用于对信息资源进行补充、提示性说明。

请求操作

XML元素名称：RequestAction。

说明：用于表明该接口数据请求的动作。请求操作由请求类型和请求参数组成。

结构如图3所示。

图3请求操作的数据结构

请求类型（Type）：用于表示该请求的操作类型，操作类型为新增、修改、删除、查询，对应值为

ADD、UPDATE、DEL、GETDATA。

请求参数（Param）：用于提供请求所需的参数，不同请求类型间所需的请求参数不同。

数据单元

XML元素名称：DataUnit。

5

DB35/T1789—2018

说明：用于描述一个数据指标项结构的最小单位，包含数据指标项的编号、标识、名称、数据类型、

约束5个属性。

结构如图4所示。

图4数据单元的数据结构

扩展属性

XML元素名称：ExtendAttribute。

说明：描述数据项的扩展信息。

7.4.3数据集

XML元素名称：DataSet。

说明：用于封装结构化的数据。数据集由一条或多条数据记录组成。

结构如图5所示。

图5数据集数据结构

数据记录标识

XML元素名称：GUID。

说明：数据记录的唯一标识。

数据记录

XML元素名称：DataRecord。

说明：组成数据集的基本单位，表示一条记录。数据记录由一个或多个数据项组成。

数据项

XML元素名称：Item。

6

DB35/T1789—2018

说明：组成数据记录的基本单位，与数据头中的数据单元对应。数据项分为数据项编号、数据项标

识、数据项名称、数据项值。

数据项编号（ItemNumber）、数据项标识（ItemID）、数据项名称（ItemName）与数据单元的编号

（DataNumber）、标识（DataID）、名称（DataName）对应。

数据项值（ItemValue）：数据项的值，值的数据类型与数据头中的数据单元的数据类型一致。

7.4.4附件集

XML元素名称：AttachmentSet。

说明：附件集用来封装非结构化数据，如文本、图像、音频、视频文件等。附件集由一个或多个附

件构成。

结构如图6所示。

图6附件集数据结构

7.4.5附件

XML元素名称：Attachment。

说明：组成附件集的基本单位，表示一个附件，附件的属性分为附件编号、附件名称、所属数据、

附件类型、描述、附件内容。

附件编号（AttNumber）：附件的编号，附件的唯一性编码。

附件名称（AttName）:附件的显示名称。如附件为文件，则附件名称包含后缀名。

所属数据（AttBelong）:用于附件与数据记录的关联，与数据集中的数据记录标识对应，一个数据

记录可对应多个附件。

附件类型（AttType）：描述该附件的类型，如1（base64转码后的二进制字符串）、2（URL链接地

址）、3（文本）等。类型1支持文件类型包括gif、jpg、jpeg、png、rar、zip、doc、docx、xls、xlsx、

wps、et、txt、pdf、avi、wmv、mpeg、mp4、mp3等，通过附件名称包含的后缀名进行数据base64转换。

描述（AttDcrp）：附件的说明描述。

附件内容（AttContent）：存储附件的内容，根据附件类型存储相应的值。

7

DB35/T1789—2018

AA

附录A

（规范性附录）

数据指标项

A.1企业信息

企业信息见表A.1。

表A.1企业信息表

编号标识名称数据类型约束

0001USCC统一社会信用代码CN18必填

0002Company机构名称CN..200必填

0003LegalMan法定代表人或负责人姓名CN..100必填

0004IdcardType法定代表人或负责人证件类型CN..50必填

0005LegalmanIdcard法定代表人或负责人证件号码CN..25必填

0006Address注册地址CN..400必填

0007AreaCode注册地址行政区划代码N6必填

0008PROAddr生产经营地址CN..400必填

0009PROAreaCode生产经营地址行政区划代码N6必填

0010Contacts联系人CN..100必填

0011Tel联系电话CN..18必填

A.2资质信息

A.2.1行政许可信息

行政许可信息见A.2。