【地方标准】 食品安全追溯信息系统接口技术导则

DB33/T1417—2025
食品安全追溯信息系统接口技术导则
Interface technical specification of food safety traceability information system

发布日期：2025-01-22
实施日期：2025-02-22
发布机构：浙江省市场监督管理局

前言
DB33/T1417—2025
本标准按照 GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。本标准的某些内容可能涉及专利。本标准的发布机构不承担识别专利的责任。本标准由浙江省市场监督管理局提出、归口并组织实施。
本标准起草单位：湖州市市场监督管理局、浙江省质量科学研究院、绍兴市能源检测院、浙江方圆检测集团股份有限公司、江山市市场监督管理局、德清县市场监督管理局、嘉兴市市场监督管理局、遂昌县市场监督管理局、浙江省市场监督管理数字传媒中心、苍南县市场监督管理局、政采云有限公司、阿里云计算有限公司、杭州农副产品物流网络科技有限公司、杭州半云科技有限公司、杭州联华华商集团有限公司、衢州市衢江区检验检测中心、嘉兴聚水潭智能科技有限公司。
本标准主要起草人：闻雪娅、郭锐、程璐璐、潘凯凌、姚璇、邱勤丽、杨春、徐超、赵江涛、陈斌、高壮飞、潘凌骏、杨清潭、崔芳芳、郑剑、杜志才、温建东、过李辉、黄冠、陶炜、李博、焦站静、万家武、李洋、徐翔、谢晓东、周肖君、王美蓉、沈仙兰、张雪婷、郝禾琼、曹张华。

1 范围
本标准规定了食品安全追溯信息系统的总体要求、接口类型、管理要求、接口报文、安全要求、接口应用、接口说明文档。
本标准适用于食品安全追溯信息系统的接口设计和管理。

2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本标准；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。
GB/T 7408.1 日期和时间信息交换表示法 第一部分：基本原则
GB/T 35274 信息安全技术 大数据服务安全能力要求
GB/T 38155 重要产品追溯 追溯术语
RFC 2818 TLS上的HTTP (HTTP over TLS)
RFC 3548 Base16、Base32、Base64数据编码 (The Base64, Base32, and Base64 Data Encodings)
RFC 3629 UTF-8, ISO 10646转换格式 (UTF-8, a transformation format of ISO 10646)
RFC 4627 JSON格式定义 (The application/json MediaType for JavaScript Object Notation)

3 术语和定义
GB/T 38155 界定的术语和定义适用于本标准。

4 总体要求
食品安全追溯信息系统接口与通过服务调用所需的信息，应符合以下要求：
1) 底层承载协议应符合 RFC 2818 的规定；
2) 字符集应符合 RFC 3629 的规定；
3) 日期类型应符合 GB/T 7408.1 的规定；
4) 图片、文件转换为字符串应符合 RFC 3548 的规定；
5) 接口响应应符合 RFC 4627 的规定；
6) 应建立接口日志记录，能识别数据异常和追踪交换数据情况；
7) 发生错误时，接口应把详细的错误代码和错误信息返回给接口使用方。

5 接口类型
食品安全追溯信息系统的数据接口包括数据查询接口、数据修改接口、数据增加接口和数据删除接口，供食品和食用农产品生产经营者及第三方追溯系统使用。
数据查询接口：用于数据的查询或下载操作。