ICS35.020 CCSL70 6101 西安市地方标准 DB6101/T3188—2024 检验检测数据管理规范数据接口 2024-06-04发布 2024-07-04实施 西安市市场监督管理局  发布DB6101/T3188—2024 I目次 前 言............................................................................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 参考文献........................................................................11DB6101/T3188—2024 II前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由西安市市场监督管理局提出并归口。 本文件起草单位：瑞特认证检测集团有限公司、陕西瑞智信息技术有限公司、中铁一局集团有限公 司、陕西汉通建设工程质量检测有限公司、陕西省建筑工程质量检测中心有限公司、西安市质量与标准 化研究院、陕西北佳信息技术有限责任公司、国网陕西省电力公司西安供电公司、湖北铁建工程检测有 限公司。 本文件主要起草人：王晖、周强、祝凯、畅亚文、张源、刘欣、王彬彬、曹珺溥、胡亚芹、王佩、 张琛、王雨润、王磊、荀漪、郭丹。 本文件由瑞特认证检测集团有限公司负责解释。 本文件首次发布。 本文件在实施过程中如有疑问或建议，请将咨询或修改建议等信息反馈至下列单位: 单位：瑞特认证检测集团有限公司 地址：陕西省西安市蓝田县华胥镇西北家具工业园新港七路8号 电话：029-82889599 邮编：710523DB6101/T3188—2024 1检验检测数据管理规范数据接口 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接口通信 通信方式 应明确通信方式，适用时包括：同步应答、异步应答、广播通知、文件传输等。 通信要求 采用不同的通信方式时，应符合： ——同步应答时，发起方向接收方发送检验检测数据请求，发送方等待接收方处理结果，接收方 应处理，并返回处理结果； ——异步应答时，发起方向接收方发送检验检测数据请求，发起方不再等待接收方处理结果，由 接收方处理完成后向发起方发送回执；DB6101/T3188—2024 2——广播通知时，发送方向一个或者多个接收方以广播通知的方式推送单个或者多个信息，由接 收方在适当的时候处理信息； ——文件传输时，发送方和接收方通过文件的方式来传输信息。 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委托信息参数DB6101