DB6101/T 3188-2024 检验检测数据管理规范 数据接口

ICS35.020

CCSL70

6101

西安市地方标准

DB6101/T3188—2024

检验检测数据管理规范数据接口

2024-06-04发布2024-07-04实施

西安市市场监督管理局  发布

DB6101/T3188—2024

目次

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

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

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

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

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

5接口通信.............................................................................1

通信方式.........................................................................1

通信要求.........................................................................1

6接口传输.............................................................................2

传输协议.........................................................................2

传输内容.........................................................................2

7接口格式.............................................................................2

8接口报文.............................................................................2

报文结构.........................................................................2

报文头...........................................................................2

报文体...........................................................................2

9接口验证.............................................................................8

验证内容.........................................................................8

验证环境.........................................................................8

验证方式.........................................................................8

附录A（资料性）报文信息JSON结构示例...........................................9

附录B（资料性）报文信息XML结构示例...........................................10

参考文献........................................................................11

I

DB6101/T3188—2024

前言

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

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由西安市市场监督管理局提出并归口。

本文件起草单位：瑞特认证检测集团有限公司、陕西瑞智信息技术有限公司、中铁一局集团有限公

司、陕西汉通建设工程质量检测有限公司、陕西省建筑工程质量检测中心有限公司、西安市质量与标准

化研究院、陕西北佳信息技术有限责任公司、国网陕西省电力公司西安供电公司、湖北铁建工程检测有

限公司。

本文件主要起草人：王晖、周强、祝凯、畅亚文、张源、刘欣、王彬彬、曹珺溥、胡亚芹、王佩、

张琛、王雨润、王磊、荀漪、郭丹。

本文件由瑞特认证检测集团有限公司负责解释。

本文件首次发布。

本文件在实施过程中如有疑问或建议，请将咨询或修改建议等信息反馈至下列单位:

单位：瑞特认证检测集团有限公司

地址：陕西省西安市蓝田县华胥镇西北家具工业园新港七路8号

电话：029-82889599

邮编：710523

II

DB6101/T3188—2024

检验检测数据管理规范数据接口

1范围

本文件规定检验检测数据管理的数据接口通信、接口传输、接口格式、接口报文和接口验证的要求。

本文件适用于西安市检验检测数据管理的数据接口要求。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408.1日期和时间信息交换表示法第1部分：基本原则

DB6101/T3182—2024检验检测数据管理规范数据元

3术语和定义

本文件没有需要界定的术语和定义。

4缩略语

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

FTP:文件传输协议（FileTransferProtocol）

HTTP:超文本传输协议（HyperTextTransferProtocol）

HTTPS：超文本安全传输协议（HyperTextTransferProtocoloverSecureSocketLayer）

IP：网络之间互联的协议(InternetProtocol)

JSON：JavaScript对象表示法(JavaScriptObjectNotation）

URL：统一资源定位符(UniformResourceLocator)

XML：可扩展标记语言（ExtensibleMarkupLanguage）

5接口通信

通信方式

应明确通信方式，适用时包括：同步应答、异步应答、广播通知、文件传输等。

通信要求

采用不同的通信方式时，应符合：

——同步应答时，发起方向接收方发送检验检测数据请求，发送方等待接收方处理结果，接收方

应处理，并返回处理结果；

——异步应答时，发起方向接收方发送检验检测数据请求，发起方不再等待接收方处理结果，由

接收方处理完成后向发起方发送回执；

1

DB6101/T3188—2024

——广播通知时，发送方向一个或者多个接收方以广播通知的方式推送单个或者多个信息，由接

收方在适当的时候处理信息；

——文件传输时，发送方和接收方通过文件的方式来传输信息。

6接口传输

传输协议

应支持多种传输协议，满足机密性、完整性、可用性的要求，包括但不限于：

——HTTP、FTP和Socket(套接字)：应对传输信息的部分或者全部内容进行加密、签名等方式进

行处理，以防止在传输过程中造成的数据泄密和数据篡改；

——HTTPS：应采用有效认证方式，以保障交互双方的有效性和合法性。

传输内容

接口传输的检验检测数据元、数据类型、数据格式、约束条件应符合DB6101/T3182—2024中第6

章、第7章的要求。

7接口格式

接口格式应包括但不限于：

a)接口地址：请求的URL地址，一般由域名或IP地址、端口号、接口路径组成；

b)接口名称：数据接口的名称，一般为接口功能描述；

c)接口参数：数据接口访问的输入条件，应符合第8章的要求；

d)返回参数：数据接口返回的输出内容，应符合第8章的要求；

e)返回状态：数据接口的调用状态码。

注：接口调用状态码，可以采用协议定义或自定义的状态码。

8接口报文

报文结构

报文结构中应包含报文头、报文体，支持多种格式，包括但不限于JSON和XML。JSON结构示例参见

附录A。XML结构示例参见附录B。

注：FTP、Socket报文结构可参考上述方式。

报文头

报文头用于表述报文中的通用信息，包括但不限于以下信息：

——调用标识：接口调用方的唯一标识；

——响应标识：接口响应方的唯一标识；

——身份令牌：身份验证和授权标识；

——发送时间：接口报文发送的时间，其时间格式应符合GB/T7408.1的规定。

报文体

8.3.1委托信息参数

2

DB6101/T3188—2024

委托信息参数应包含委托方信息、委托样品信息、检/试验要求信息、检/试验项目信息。委托方信

息应符合表1的要求，委托样品信息应符合表2的要求，检/试验要求信息应符合表3的要求，检/试验项

目信息应符合表4的要求。

表1委托方信息参数

参数名含义类型是否必填项说明

customerName委托方名称String是委托方名称

customerContact委托方联系人String是委托方联系人

customerPhone委托方电话String是委托方电话

customerAddress委托方地址String否委托方地址

表2委托样品信息参数

参数名含义类型是否必填项说明

sampleName样品名称String是样品名称

sampleTrademark样品商标String否样品商标

sampleProduceUnit生产单位String是样品生产单位

sampleProduceUnitAdress生产单位地址String是生产单位地址

sampleModel样品规格String是样品规格

sampleCount样品数量Float是样品数量

sampleUnit样品单位String是最小独立包装规格的单位

sampleProducedDate生产日期Date是样品生产日期

sampleValidDate有效期String否样品有效期

sampleValidEndDate有效期截止日期Date否样品有效期截止日期

sampleFormerNumber样品批号String是样品批号

sampleLicenseNumber生产许可证号String否样品生产许可证号