DB35 ICS 35.240 L 67 福 建 省 地 方 标 准 DB35/T 1789—2018 质量监督信息资源数据交换接口规范 Specification for data exchange interface of quality supervision information resources 2018 - 09 - 11 发布 福建省质量技术监督局 2018 - 12 - 11 实施 发 布 DB35/T 1789—2018 目 次 前 言 .............................................................................. II 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 4 缩略语 ............................................................................ 1 5 数据交换模式 ...................................................................... 2 6 数据指标项 ........................................................................ 2 7 数据交换接口 ...................................................................... 3 附录 A（规范性附录） 数据指标项 ...................................................... 8 附录 B（资料性附录） 接口身份认证格式样例 ........................................... 16 附录 C（资料性附录） 数据接口模型封装数据格式样例 ................................... 17 I DB35/T 1789—2018 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由福建省质量技术监督局行政服务中心提出。 本标准由福建省质量技术监督局归口。 本标准起草单位：福建省质量技术监督局行政服务中心、福建省经济信息中心。 本标准主要起草人：谢丹、陈绍林、徐侃、郑开新、魏祯、游鄂平、林钟。 II DB35/T 1789—2018 质量监督信息资源数据交换接口规范 1 范围 本标准规定了省质量监督信息资源数据交换术语和定义、缩略语、数据交换模式、数据指标项以及 数据交换接口。 本标准适用于省质量监督信息资源数据交换。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18391.1 信息技术 元数据注册系统(MDR) 第1部分：框架 3 术语和定义 下列术语和定义适用于本文件。 3.1 数据交换 data exchange 各类实体之间相互提供数据的过程。 [GB/T 36107-2018,定义3.1] 3.2 质量监督信息资源 quality supervision information resources 省质监系统各单位及其他有关单位、部门在实现质量安全监管控制过程中，采用文字和符号形式存 储在一定载体（包括文件、资料、图表、网页、数据等）之上的，可供利用的全部信息的总称。 3.3 质量监督信息资源数据交换平台 quality supervision information resources data exchange platform 通过计算机网络在若干个信息系统之间实现质量监督信息资源数据的抽取、转换、集中、加载、展 现等数据交换操作的信息系统。 4 缩略语 下列缩略语适用于本文件。 URL 统一资源定位符（Uniform Resource Locator） XML 可扩展标记语言（Extensible Markup Language） 1 DB35/T 1789—2018 5 数据交换模式 5.1 总体框架 采用Web Service技术，通过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/T 1789—2018 表2 数据类型表 字符 含义 通过字符形式表达的值的类型。C后加自然数表示定长字符串，如C6表示6个定长字符（一 C 个汉字相当于两个字符）。 通过可计算的十进制形式表达的值的类型。N后加自然数表示定长数值，如N4表示4位定 N 长数字。 CN 包括字符型和十进制数字，CN后加自然数表示定长数值，如CN5表示5个字符和/或数字。 日期型，通过YYYYMMDD形式表达的值的类型，符合GB/T 7408的规范。用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 数据安全 身份认证：通过调用Web Service方法，在数据交换报文头中增加身份认证消息报文，实现对接口 调用方的身份认证。接口身份认证XML文件详细格式参见附录B。 授权控制：接口调用方根据授权的数据权限进行数据调用。 数据加密：数据传输前须通过国密SM2算法对生成的XML信息进行加密。 7.2 接口调用 通过HTTP请求格式调用服务将请求参数包含在请求的URL中，调用成功后，以XML格式返回结果，失 败时返回相应的错误信息。 7.3 接口定义格式 接口应满足以下要求，具体内容要根据数据类型和实际部署情况进行修改： 接口类型：Web Service（SOAP或REST风格）； 接口地址：http://[host]:[port]/[context]，包括： [host]：系统IP地址； [port]：系统访问端口号； [context]：功能接口名称。主要包括接口名、参数、参数之间用&隔开。 7.4 数据交换接口模型 7.4.1 模型结构 3 DB35/T 1789—2018 数据接口模型用于数据交换时封装交换信息，支持结构化数据和非结构化数据的封装。 数据接口模型由数据头、数据集、附件集组成。 结构如图1所示。 图1 数据接口模型结构 数据接口模型封装数据的XML文件详细格式参见附录C。 7.4.2 数据头 7.4.2.1 数据头结构 数据头由信息资源标识、信息资源名称、信息资源注释、请求操作、数据单元、扩展属性6个元素 组成。 结构如图2所示。 图2 数据头的数据结构 7.4.2.2 信息资源标识 XML元素名称：ResourceID。 说明：交换信息的标识符，采用GB/T 18391.1中对标识符的相关规定，用于标明业务类型。调用接 口时，通过不同的标识，对不同信息资源数据进行操作。 7.4.2.3 信息资源名称 XML元素名称：ResourceName。 说明：信息资源的名称。 信息资源名称和信息资源标识对照表见表3。 4 DB35/T 1789—2018 表3 信息资源标识和名称对照表 信息资源名称 信息资源标识 企业信息 00 行政许可信息 01 地理标志产品信息 02 企业产品标准备案信息 03 地方标准题录信息 04 强制性产品认证信息 05 政府质量奖信息 06 名牌产品信息 07 标准贡献奖信息 08 标准化良好行为信息 09 产品质量监督抽查（合格）信息 10 产品质量监督抽查（不合格）信息 11 行政处罚信息 12 特种设备使用登记及检验信息 13 计量器具信息 14 7.4.2.4 信息资源注释 XML元素名称：ResourceDcrp。 说明：对信息资源的解释性描述，用于对信息资源进行补充、提示性说明。 7.4.2.5 请求操作 XML元素名称：RequestAction。 说明：用于表明该接口数据请求的动作。请求操作由请求类型和请求参数组成。 结构如图3所示。 图3 请求操作的数据结构 请求类型（Type）：用于表示该请求的操作类型，操作类型为新增、修改、删除、查询，对应值为 ADD、UPDATE、DEL、GETDATA。 请求参数（Param）：用于提供请求所需的参数，不同请求类型间所需的请求参数不同。 7.4.2.6 数据单元 XML元素名称：DataUnit。 5 DB35/T 17