DB37/T 4350—2021

重要产品追溯
食用农产品省级平台数据接口规范

2021-03-11发布
2021-04-11实施

山东省市场监督管理局 发布


前言

本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省商务厅提出、归口并组织实施。本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。本文件主要起草人：王、梁厚广、主志恒、吴业虎、朱承鑫、陈通。


1 范围

重要产品追溯 食用农产品省级平台数据接口规范
本文件规定了食用农产品省级追溯管理平台（以下简称“省级平台”）追溯数据接口的基本要求、接口类型、对接要求、接口说明。
本文件适用于省级平台与食用农产品市级追溯管理平台（以下简称“市级平台”）之间及省级平台与食用农产品追溯节点（以下简称“节点”）系统之间的对接，其他相关平台或系统的接入参照执行。


2 规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法
GB/T 18391.1 信息技术 元数据注册系统（MDR）第1部分：框架
GB/T 38154—2019 重要产品追溯 核心元数据
GB/T 38155 重要产品追溯 追溯术语
DB37/T 3659—2019 重要产品追溯 食用农产品省市平台管理规范
IETF RFC 2818 TLS上的HTTP（HTTP Over TLS）
IETF RFC 3548 Base16、Base32、Base64数据编码（The Base 16, Base 32, and Base 64 Data Encodings）
IETF RFC 3629 UTF-8，ISO 10646转换格式（UTF-8, a transformation format of ISO 10646）


3 术语和定义

GB/T 18391.1、GB/T 38155、DB37/T 3659界定的术语和定义适用于本文件。


4 缩略语

下列缩略语适用于本文件。
HTTPS：以安全为目标的HTTP通道（Hyper Text Transfer Protocol over Secure Socket Layer）
JSON：一种轻量级的数据交换格式（JavaScript Object Notation）
SHA-256：安全杂凑算法（Secure Hash Algorithm），摘要输出长度为32字节
UTF-8：一种可变长度字符编码（8-bit Unicode Transformation Format）


5 基本要求

接口通过服务调用实现信息交换，应符合下列要求：
a) 采用符合IETF RFC 2818的HTTPS协议作为底层承载协议；
b) 采用符合IETF RFC 3629规定的UTF-8字符集；
c) 采用符合GB/T 7408规定的日期类型；
d) 采用符合IETF RFC 3548规定的BASE64编码规则将图片文件转换为字符串；
e) 接口请求与接口响应均采用JSON数据格式；
f) 建立接口日志记录，能识别数据异常或追溯交换数据情况；发生错误时，接口将详细的错误信息返回至相关平台和节点系统，由各平台和节点系统对错误进行记录分析和整改。


6 接口类型

6.1 省级平台与市级平台的接口类型
主要包括下列类型：
a) 主体备案信息类：用于市级平台上报节点主体备案信息至省级平台；
b) 产品备案信息类：用于市级平台上报节点产品备案信息至省级平台；
c) 追溯业务信息类：用于市级平台上报节点追溯业务信息至省级平台，业务信息包括但不限于种植信息、养殖信息、生产加工信息、屠宰信息、批发（配送）信息、零售信息、消费信息、召回信息等。

6.2 省级平台与节点系统的接口类型
主要包括：追溯业务信息类，用于节点系统上报节点追溯业务信息至省级平台，该信息是用于面向消费者展示的追溯查询数据。


7 对接要求

7.1 接入前应按照DB37/T 3659—2019中第6章的要求提出申请、取得入驻资格。对接示意图见图1。

图1 对接示意图


8 接口说明

8.1 接口请求
（此处原文缺失具体接口请求细节，通常包含请求URL、Method、Header及Body结构定义）

8.2 接口响应
（此处原文缺失具体接口响应细节，通常包含响应状态码、数据格式及示例）


附录A（资料性）
代码类型
A.1 代码类型
A.2 消息业务类型
A.3 追溯系统类型
A.4 响应码
A.5 经营类型
A.6 流通顺序码
A.7 内部环节信息类型
A.8 检测报告类型


附录B（资料性）
业务参数示例


参考文献
（原文此处仅提及“参者文献”即参考文献，未列出具体书目，通常包含前文引用文件及其他相关标准）