DB5101 四 川 省 成 都 市 地 方 标 准 DB5101/T 2-2018 成都市食品检验检测交换数据接口规范 2018 - 07 - 01 发布 成都市质量技术监督局 2018 - 07 - 02 实施 发布 DB5101/T 2-2018 目 次 前言 ................................................................................ II 引言 ............................................................................... III 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 4 缩略语 ............................................................................ 1 5 交换要求 .......................................................................... 2 5.1 接口交换要求 .................................................................. 5.1.1 接口基本要求 .............................................................. 5.1.2 接口请求消息格式要求 ...................................................... 5.1.3 接口消息参数格式约定 ...................................................... 5.1.4 接口应答消息格式要求 ...................................................... 5.1.5 接口传输格式 .............................................................. 5.2 文件交换要求 .................................................................. 5.2.1 文件交换基本要求 .......................................................... 5.2.2 文件交换模板要求 .......................................................... 5.3 交换安全要求 .................................................................. 附录 A（资料性附录） 2 2 2 2 2 2 2 2 2 2 接口传输格式要求 ................................................ 3 I DB5101/T 2-2018 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由成都市食品药品监督管理局提出并归口。 本标准由成都市质量技术监督局批准。 本标准起草单位：成都市标准化研究院、成都市食品药品检验研究院。 本标准主要起草人：万渝平、王立山、叶梅、李南、罗军、刘莎、李茂春、向游江。 II DB5101/T 2-2018 引 言 为进一步加强食品安全检验检测数据的融合利用，实现食品安全检验检测数据互联互通、共享共治， 消除信息孤岛，运用数据分析为食品监管提供决策支持，提升我市食品安全智慧监管现代化水平，根据 《中华人民共和国食品安全法》及其实施条例、《关于进一步加强食品药品安全工作的意见》（成委发 〔2016〕14号）等有关法律、法规和文件规定，统一食品检验检测信息数据规范，特制定我市食品检验 检测交换数据接口规范。 III DB5101/T 2-2018 成都市食品检验检测交换数据接口规范 1 范围 本标准规定了食品检验检测交换数据接口的接口交换要求、文件交换要求以及交换安全要求。 本标准适用于成都市行政区域内的食品检验检测数据的交换。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 DB5101/T 1-2018 成都市食品检验检测数据交换规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 接口 计算机信息系统之间传送数据、交换信息的接口。 3.2 服务提供方 提供食品检验检测交换数据接口服务的机构。 3.3 数据提供方 通过服务提供方的接口进行食品检验检测数据交换的机构。 4 缩略语 下列缩略语适用于本文件。 HTTPS 安全超文本传输协议（Hyper Text Transfer Protocol over Secure Socket Layer） REST 表述性状态转移（Representational State Transfer） SOAP 简单对象访问协议（Simple Object Access Protocol） XML 扩展标记语言（Extensible Markup Language） 1 DB5101/T 2-2018 5 交换要求 5.1 接口交换要求 5.1.1 接口基本要求 5.1.1.1 5.1.1.2 5.1.1.3 5.1.2 支持 SOAP 协议或 REST 架构。 采用 HTTPS 通讯协议进行同步通讯。 接口部署到服务提供方服务器上，通过 Intranet/Internet 提供服务。 接口请求消息格式要求 请求消息以XML标签形式封装，数据对象及参数英文名即为XML消息中标签名，XML标签含有的英文 采用小写字母表示。 5.1.3 接口消息参数格式约定 接口消息参数格式约定如下： ——各参数若无特别说明均为字符型。 ——整数数值型参数不得存在除数字字符以外的其他字符。 ——浮点数值型参数不得存在除小数点和数字字符以外的其他字符。 ——日期型参数默认格式为“YYYY-MM-DD”。 ——时间型参数默认格式为“hh:mm:ss”。 5.1.4 接口应答消息格式要求 应答消息以XML标签形式封装，XML标签含有的英文采用小写字母表示，应答消息应包含对请求消息 进行处理的结果信息，包括： ——处理成功或失败的标志； ——处理成功或失败的原因说明。 5.1.5 接口传输格式 接口传输格式见附录A。 5.2 文件交换要求 5.2.1 文件交换基本要求 5.2.1.1 5.2.1.2 5.2.2 采用 HTTPS 通讯协议进行同步通讯。 服务提供方应提供文件交换功能，通过 Intranet/Internet 提供服务。 文件交换模板要求 服务提供方应提供文件交换模板，便于数据提供方填写数据后进行数据交换，文件交换模板参数格 式按5.1.3的规定执行。 5.3 交换安全要求 服务提供方应提供提供数据交换安全保障措施。 2 DB5101/T 2-2018 AA 附 录 A （资料性附录） 接口传输格式要求 A.1 接口定义 A.1.1 请求消息格式 请求消息包括以下参数，描述见表 A.1： ——pageNumber.cludove：返回记录的页数； ——recordNumber.cludove：每页返回记录数； ——token：身份认证加密字符串； ——format：消息格式； ——catalog.cludove：目录标识； ——test_info:检验检测交换数据信息，格式如下： <data> ·· ·· ·· </data> 表A.1 序号 参数中文 请求消息参数表 参数 参数说明 1 返回记录的页数 pageNumber.cludove 数值型，返回记录的页数 2 每页返回记录数 recordNumber.cludove 数值型，每页返回记录数, 0表示不分页 3 身份认证加密字符串 token 字符型，身份认证信息加密字符串 4 消息格式 format 字符型，值为xml或其他约定格式 5 目录标识 catalog.cludove 字符型，目录标识 6 交换数据信息 test_info 食品检验检测交换数据信息 A.1.2 应答消息格式 a) 应答消息参数表见表 A.2。 b) 应答消息格式： <data> <resultcode>处理结果代码</resultcode> <resultinfo>处理结果信息</resultinfo> </data> 表A.2 序号 参数中文 应答消息参数表 参数 参数说明 1 处理结果代码 resultcode 结果代码：1-成功；0-失败 2 处理结果信息 resultinfo 结果信息描述 3 DB5101/T 2-2018 A.2 接口实例 A.2.1 A.2.1.1 抽样检验基本信息接口 请求消息格式 请求消息包括以下参数，描述见表 A.3： ——pageNumber.cludove：返回记录的页数； ——recordNumber.cludove：每页返回记录数； ——token：身份认证加密字符串； ——format：消息格式； ——catalog.cludove：目录标识； ——test_info: 检验检测交换数据信息（抽样检验基本信息），格式如下： <data> <samplelistno>抽样单编号</samplelistno> <tasksource>任务来源</tasksource> ·· ·· ·· <fillper>填报人</fillper> <filldate>填报日期</filldate> <attach>附件