DB31/T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分：数据接口

ICS35.240.99

CCSL78

长江三角洲区域地方标准

DB31/T310024.3—2024

DB32/T310024.3—2024

DB33/T310024.3—2024

DB34/T310024.3—2024

长三角地区食品和食用农产品信息追溯

第3部分：数据接口

YangtzeRiverDeltainformationtraceabilityforfoodandedibleagricultural

products—Part3:Datainterface

2024-05-17发布2024-09-01实施

上海市市场监督管理局

江苏省市场监督管理局

发布

浙江省市场监督管理局

安徽省市场监督管理局

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

目次

前言II

引言III

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5数据接口技术要求2

6数据结构3

7服务功能类型4

8接口安全4

附录A（资料性）长三角食品安全信息追溯平台数据接口JSON格式数据示例5

I

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

本文件为DB31/T310024《长三角地区食品和食用农产品信息追溯》的第3部分。DB31/T310024

已经发布了以下部分：

——第1部分：通则；

——第2部分：数据元；

——第3部分：数据接口。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由上海市市场监督管理局、江苏省市场监督管理局、浙江省市场监督管理局、安徽省市场监

督管理局联合提出、归口并组织实施。

本文件主要起草单位：上海仪电溯源科技有限公司、上海市质量和标准化研究院、上海市农业科学

院、上海海关动植物与食品检验检疫技术中心、江苏省质量和标准化研究院、浙江省标准化研究院、浙

江省市场监督管理数字传媒中心、阿里云计算有限公司、安徽省质量和标准化研究院。

本文件主要起草人：柳凌、胡传鑫、邵逸超、陈艳、阮丽芳、朱殊瑶、陈志明、潘明阳、崔诚、卜

奎昊、陈青宇、管旭琳、章学周、侯月丽、杨博、程禹、鲁轮、周超群、徐振、彭海涛、王献礼、齐相

峰、蔡丽华、石念、朱婕、那晶、过李辉、程璐璐、李博、闻天、丁炜、郭锐、钱文婧、骆琳、安金林、

陈寿赛、叶文倩、郭德华、杨捷琳。

II

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

引言

本文件旨在推动构建区域联动的食品安全信息追溯体系。DB31/T310024由三个部分构成。

——第1部分：通则。目的在于为长三角地区食品和食用农产品信息追溯平台建设工作提供指导。

——第2部分：数据元。目的在于用来准确无歧义定义长三角地区食品和食用农产品的数据元分

类方式和相关数据元信息。

——第3部分：数据接口。目的在于为长三角地区食品和食用农产品信息追溯平台数据接口的设

计、开发和应用提供指导。

本文件系统梳理了长三角地区食品和食用农产品信息追溯平台中各个参与方在数据收集、存储、传

递和共享过程，研究编制了长三角地区食品和食用农产品信息追溯平台数据接口的数据结构和数据接口

输出文件，确保数据的互操作性、一致性和安全性。

III

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

长三角地区食品和食用农产品信息追溯

第3部分：数据接口

1范围

本文件规定了长三角地区食品和食用农产品追溯的数据接口技术要求、数据结构、服务功能类型和

接口安全要求。

本文件适用于长三角地区（上海市、江苏省、浙江省、安徽省）食品和食用农产品追溯信息交换、

共享、传输和认证的接口实现。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408—2005数据元和交换格式信息交换日期和时间表示法

GB/T38155重要产品追溯追溯术语

DB31/T310024.1长三角地区食品和食用农产品信息追溯第1部分：通则

DB31/T310024.2长三角地区食品和食用农产品信息追溯第2部分：数据元

IETFRFC2818TLS上的HTTP(HTTPoverTLS)

IETFRFC3548Base16、Base32、Base64数据编码（TheBase16,Base32,andBase64DataEncodings）

IETFRFC3629UTF-8，ISO10646转换格式（UTF-8,atransformationformatofISO10646）

IETFRFC4627JSON格式定义(Theapplication/JSONMediaTypeforJavaScriptObject

Notation)

3术语和定义

GB/T38155、DB31/T310024.1界定的以及下列术语和定义适用于本文件。

3.1

数据接口datainterface

用于数据交换的服务，包括服务的功能、位置以及通讯的协议、传输格式和认证方法。

3.2

安全认证securitycertificate

保证数据传输安全的加密方法和身份认证方法。

3.3

数字令牌digitaltoken

分发给传输方，代表传输方身份及权限的加密字符串。

4缩略语

1

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

下列缩略语适用于本文件。

CA：数字证书认证机构（CertificateAuthority）

HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript对象标记（JavaScriptObjectNotation）

TLS：传输层安全协议（TransportLayerSecurity）

URL：统一资源定位符（UniformResourceLocator）

UTF-8：一种可变长度字符编码（8-bitUnicodeTransformationFormat）

5数据接口技术要求

5.1基本要求

长三角地区食品和食用农产品信息追溯数据接口通过服务调用获取所需的信息，应符合下列要求：

a)采用符合IETFRFC2818的HTTPS协议作为底层承载协议；

b)采用符合IETFRFC3629规定的UTF-8字符集；

c)采用符合GB/T7408规定的日期类型；

d)采用符合IETFRFC3548规定的Base64编码规则将图片、文件二进制字节流转换为字符串；

e)接口响应采用IETFRFC4627规定的JSON数据格式；

f)建立接口日志记录，能识别数据异常或追溯交换数据情况；

g)发生错误时，接口将详细的错误代码和错误信息返回给接口使用方，以利于接口使用方进行

记录分析和整改。

5.2接口格式定义

数据接口格式定义主要包括：

a)接口地址：请求的URL地址，一般由域名或IP、端口号、接口路径组成，参见附录A中A.1；

b)功能说明：数据接口功能的简要描述，参见附录A中A.2；

c)参数说明：调用数据接口的输入参数或者输出参数情况，参见附录A中A.3；

d)请求示例：数据接口的请求参数示例，参见附录A中A.4；

e)返回示例：数据接口调用正常或异常的报文主体示例，参见附录A中A.5；

f)接口响应码说明：数据接口的响应状态码，参见附录A中A.6。

5.3数据类型

数据接口应支持的数据类型包括：

a)字符型，用String表示；

b)整数型，用Integer表示；

c)浮点型，用Float表示；

d)布尔型，用Boolean表示；

e)日期时间型，用DateTime表示，应符合GB/T7408-2005中定义的扩展时间表示法。日期格

式为：YYYY-MM-DD，时区为中国北京时间(GMT+8)；时间格式为：YYYY-MM-DDThh:mm:ss，时

区为中国北京时间(GMT+8)；根据信息交换中各方的约定，在不会引起日期和时间组合的日

的表示法与本文件定义的其他表示法出现混淆的情况下，字符[T]可以省略；

2

DB31/T310024.3—2024DB32/T310024.3—2024

DB33/T310024.3—2024DB34/T310024.3—2024

f)文件型，用字符串标识，应采用data:<mediatype>；base64,<data>的字符串格式进行拼接。

其中：<mediatype>表示文件的类型，例如application/pdf；<data>表示文件二进制字节

流的Base64编码字符串；

g)对象型，用Object表示，对应JSON中的“对象符号”；

h)数组型，用Array表示，是一个或多个