DB33/T 1417-2025 食品安全追溯信息系统接口技术导则

以下是浙江省地方标准《DB33/T 1417-2025 食品安全追溯信息系统接口技术导则》主要内容的详细总结：

​​1. 适用范围​​

适用于浙江省内食品安全追溯信息系统的接口设计、开发和管理，涵盖食品及食用农产品生产者、批发/零售经营者、餐饮服务提供者、第三方追溯系统及物联设备的对接。

​​2. 核心要求​​

​​总体要求​​

• ​​协议与格式​​：
  • 底层协议：HTTPS（符合 IETF RFC 2818）。
  • 字符集：UTF-8（IETF RFC 3629）。
  • 日期格式：ISO 8601（GB/T 7408.1）。
  • 文件编码：图片/文件需转为 Base64 字符串（IETF RFC 3548）。
  • 响应格式：JSON（IETF RFC 4627）。
• ​​日志与错误处理​​：
  • 必须记录接口日志，支持数据异常追踪。
  • 错误时返回详细错误码及信息（如 resultCode、resultMessage）。

​​接口类型​​

​​3. 管理流程​​

1. ​​接口测试​​：
   • 用户需通过测试包（含安全SDK、测试接口、密钥）完成测试。
2. ​​接口申请​​：
   • 提交接口名称、功能描述、权限、使用目的等信息。
3. ​​接口激活​​：
   • 平台审核后分配企业密钥并激活接口。
4. ​​接口应用​​：
   • 支持企业系统、第三方追溯系统、物联设备对接。
5. ​​接口维护​​：
   • 平台管理员负责监控、维护及漏洞处理。

​​4. 接口报文规范​​

​​请求报文​​

• ​​请求头（Header）​​：

  字段	说明
  appKey	平台分配的应用标识（必填）
  appMessageId	消息流水号（唯一标识）
  nonce	4位随机数（防重放攻击）
  signature	请求参数的SHA256签名值
  timestamp	UTC时间戳（毫秒级）
  version	接口版本号

• ​​请求体（Body）​​：

  • 参数格式按接口功能定制（见表2），如生产企业上报需包含产品名称、批次号、原料信息等（附录A示例）。

​​响应报文​​

• ​​响应头（Header）​​：

  字段	说明
  resultCode	响应状态码（如 0 表示成功）
  resultMessage	响应详情（如 "success"）
  其他字段同请求头

• ​​响应体（Body）​​：

  • 包含业务数据（如 data 字段）或错误详情。

​​5. 安全要求​​

​​基础安全​​

• 符合 ​​GB/T 35274​​ 大数据服务安全要求。
• 平台提供 ​​安全传输SDK​​，初始化参数由平台分配。
• 多重校验机制：
  • IP白名单、数字签名、防重放（nonce+timestamp）。
  • 调用频次、时间段、接口权限控制。

​​加密规则​​

• ​​签名算法​​：
  SHA256 签名 → 转为 HEX 字符串。
• ​​加密算法​​：
  • 步骤：AES/CBC 加密 → Base64 编码。
  • 密钥：128位，初始向量为16位 nonce（不足补0）。
  • 数据编码：UTF-8 字节数组 → 加密 → Base64 输出。

​​6. 接口应用场景​​

​​7. 接口文档要求​​

• 必须提供详细说明文档，包含：
  • 调用协议、数据格式、字符集、安全约定。
  • 每个接口的 ​​功能说明​​、​​调用地址​​、​​请求/响应参数​​、​​报文示例​​。
  • 技术支持联系人信息。

​​附录A：接口示例​​

• ​​场景​​：生产企业上报桂花糕产品信息。
• ​​请求体关键字段​​：

  "productName": "桂花糕",  "barCode": "6901234567892",  "rawMaterial": [    {"materialName": "面粉", "batchNumber": "03245467282143"}  ]  

• ​​响应成功标志​​：

  "code": "0",  "msg": "操作成功",  "success": "1"  

​​标准核心价值​​

1. ​​统一性​​：规范数据格式、加密方式、交互协议，实现跨系统互通。
2. ​​安全性​​：通过多重加密与校验机制保障数据可信传输。
3. ​​可追溯性​​：明确各环节数据要求，支撑全链条追溯。
4. ​​可扩展性​​：支持企业、第三方系统及物联设备灵活接入。

此标准为浙江省构建食品安全追溯体系提供了技术基准，确保追溯数据的准确性、完整性与安全性。