DB53/T 1136.3-2022 食品安全信息追溯基础技术规范 第3部分：数据接口

ICS35.240.99

CCSL78

53

云南省地方标准

DB53/T1136.3—2022

食品安全信息追溯基础技术规范

第3部分：数据接口

2022-10-26发布2023-01-26实施

云南省市场监督管理局  发布

DB53/T1136.3—2022

前言

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

起草。

本文件是DB53/T1136《食品安全信息追溯基础技术规范》的第3部分。DB53/T1136一共发布以下3

个部分：

——第1部分：编码方法；

——第2部分：数据元；

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

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

本文件由云南省市场监督管理局提出并归口。

本文件起草单位：云南省市场监督管理局信息中心、云南省市场监督管理局、云南省标准化研究院、

中国移动通信集团云南有限公司、云南省盐业有限公司、云南鼎耀信息技术有限公司、昆明雪兰牛奶有

限责任公司、云南绿A生物工程有限公司。

本文件主要起草人：杨东霞、张娴、陈红丽、杨亚琦、杨增鸿、谢波、朱勋程、赵忆宁、李宁、黄

典一、杨俊、韩骥、赵欣、易正禹、邹汉铮、桑月军、宋治金、李文媛、陈福波、朱宁、林男、杨志、

金荣、段玉娟、荀春、余凡、左仕陆、杨康定。

I

DB53/T1136.3—2022

引言

食品安全始终是关系国计民生的大事。追溯体系的建立作为保障食品安全的重要管理手段一直是社

会关注的重点工作。从国内外追溯体系建设和实施的成效可以看出，建立追溯体系是一种能够预防和改

善食品安全问题的有效途径。在信息化技术应用于追溯体系建设过程中，追溯编码、数据元和数据接口

是重要的基础性工作。科学制定标准规范有利于实现追溯数据互联互通和追溯体系的推广应用。《食品

安全信息追溯基础技术规范》拟由三个部分构成：

——第1部分：编码方法。目的在于给出食品安全追溯体系中追溯码编码方法和表示要求；

——第2部分：数据元。目的在于给出食品安全追溯体系中基础数据元及其描述规则；

——第3部分：数据接口。目的在于给出食品安全追溯体系中生产企业数据上传信息的接口要求。

II

DB53/T1136.3—2022

食品安全信息追溯基础技术规范第3部分：数据接口

1范围

本文件规定了食品安全信息追溯的数据接口技术要求、数据接口参数和接口安全。

本文件适用于食品安全信息追溯的数据交换、传输和认证。

2规范性引用文件

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

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

文件。

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

GB/T7635.1全国主要产品分类与代码第1部分：可运输产品

GB12904商品条码零售商品编码与条码表示

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

RFC1945超文本传输协议1.0(Hypertexttransferprotocol--HTTP/1.0)

RFC2616超文本传输协议1.1(Hypertexttransferprotocol--HTTP/1.1)

RFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptObjectnotation)

RFC4825可扩展标记语言配置接入协议(Theextensiblemarkuplanguage(XML)configuration

accessprotocol(XCAP))

3术语和定义

下列术语和定义适用于本文件。

数据接口datainterface

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

接口协议interfaceprotocol

需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体

内容等，确定通信程序发送消息和接收消息的规则。

消息头MessageHeader

消息头包含了关于消息本身的元数据（例如，发送者和目标详细信息、消息属性、消息类型），不

同传输的头包含不同类型的信息。

安全认证securitycertificate

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

“名称/值”对name/valuepair

1

DB53/T1136.3—2022

JSON的数据存储格式，“名称/值”对组合中的名称写在前面双引号中，值写在后面双引号中，中

间用冒号隔开，“名称/值”对之间由逗号分隔。

追溯码traceabilitycode

追溯系统中对追溯单元进行唯一标识的代码。

[来源：GB/T38155—2019，2.10]

4缩略语

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

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

JSON：一种轻量级的数据交换格式(JavaScriptObjectNotation)

MD5：消息摘要算法第五版（Message-DigestAlgorithm5）

RESTFul：基于HTTPS协议，可以使用XML格式定义或JSON格式定义

Token：是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌”

URL：互联网服务程序上用于指定信息位置的表示方法（UniformResourceLocator）

UTF-8：一种可变长度字符编码(8-bitUnicodeTransformationFormat)

XML：可扩展标记语言（ExtensibleMarkupLanguage）

5技术要求

基本要求

5.1.1接口要求

接口通过服务调用实现信息交换，应符合下列要求：

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

——接口请求与接口响应均采用JSON数据格式；

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

5.1.2容错要求

发生错误时，接口服务方将详细的错误信息返回至接口调用方，由接口调用方对错误进行记录分析

和整改。

接口协议

接口协议方式包括：

——采用基于HTTPS传输协议的RESTFul接口方式；

——采用JSON格式报文打包方式。

消息头基本参数

5.3.1安全认证接口Header参数

安全认证接口Header参数见表1。

2

DB53/T1136.3—2022

表1安全认证接口Header参数表

参数名称参数描述

Authorization接口授权

（其余字段）采用默认值

5.3.2业务交互接口Header参数

业务交互接口Header参数见表2。

表2业务交互接口Header参数表

参数名称参数描述

Authorization接口授权

授权token，格式为：bearer+token例如：

bearer

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJpc3N1c2VyIiwiYXVkIjoiYXVkaWVuY2UiL

CJ0ZW5hbnRfaWQiOiIwMDAwMDAiLCJ1c2VyX25hbWUiOiLkupHljZfkupHpgJ_kv6Hmga_mioDmnK_mnIn

pmZDlhazlj7giLCJ0b2tlbl90eXBlIjoiYWNjZXNzX3Rva2VuIiwicm9sZV9uYW1lIjoiZW50ZXJwcmlzZ

Trace-AuthSIsInVzZXJfdHlwZSI6Im1hc3RlciIsInVzZXJfaWQiOiI5OTY0NTgzMDUxMTgxMjE4MyIsInJvbGVfaWQ

iOiIxNDAyNDM3NTkyMDc4NzQ5Njk3Iiwibmlja19uYW1lIjoi5LqR5Y2X5LqR6YCf5L-h5oGv5oqA5pyv5

pyJ6ZmQ5YWs5Y-4IiwiZGV0YWlsIjp7InR5cGUiOiJ3ZWIifSwiZW50ZXJwcmlzZV9jb2RlIjoiOTE1MzA

xMDJNQTZLNEtBNTdRIiwiZGVwdF9pZCI6IjIzNyIsImFjY291bnQiOiI5MTUzMDEwMk1BNks0S0E1N1EiL

CJjbGllbnRfaWQiOiJzYWJlciIsImV4cCI6MTY1NTM3MDM4MCwibmJmIjoxNjU1MzY2NzgwfQ.M8o2wrI6

eKb9JovCDKLGhZVAB4k4tmwA-GmUGEGzZ71zCStoL62e0vmRlzppuniuOcvQa8cbqHyz1E_uk-MyEQ

（其余字段）采用默认值

基本数据类型

基本数据类型说明见表3。

表3数据类型说明表

类型名称类型说明

String字符串

Integer整型

File文件类型

Datetime日期格式：yyyymmdd,依据GB/T7408

Array数组类型

Boolean布尔类型。真值：true；假值：false

ObjectJSON对象类型

6数据接口

数据接口分类

3

DB53/T1136.3—2022

数据接口分类见图1所示。

图1数据接口分类

基本信息接口

6.2.1安全认证接口

获取用户登录token信息，进行用户安全认证，相关参数见表4。

表4安全认证接口数据

参数名称数据类型长度（Byte）是否必填描述

userNameString32是用户名，企业统一社会信用代码

passWordString45是登录密码，密码使用MD5加密

tenanIIdString12是租用号

grantTypeString45是授权类型，固定填写：password

scopeString255是权限，默认填写：all

6.2.2商品类别查询接口

查询追溯商品类别，参数见表5。

表5商品类别查询接口数据

参数名称数据类型长度（Byte）是否必填描述

goodsCatalogIdInteger64是商品类别号

goodsCatalogNameString32是商品类别

查询追溯商品类别，返回值见表6。

4

DB53/T1136.3—2022

表6商品类别查询返回值

参数名称数据类型长度（Byte）描述

goodsCataloCodeString32商品类别代码

goodsCatalogNameString32商品类别

parentIdInteger64上级类别号

6.2.3图片文件上传接口

上传食品追溯相关数据时所需提供的图片文件，参数见表7。

表7图片文件上传接口数据

参数名称数据类型长度（Byte）是否必填描述

图片文件。

fileFile5242880是格式要求：png、jpg、jpeg

大小限制：不超过5MByte

文件名（注：已经封装过，在

nameString32是其它接口中使用该值作为图

片文件地址）

图片文件上传接口，返回值见表8。

表8返回值

参数名称数据类型长度（Byte）描述

codeInteger(int32)32状态码，见附录表A.1

dataObject4096承载数据

msgString64提示信息

successBoolean8返回结果类型

6.2.4新增食品生产经营市场主体信息备案

上传新增食品生产企业、食品经营企业的基本备案信息，如：企业统一社会信用代码、企业名称等，

参数见表9。

表9新增食品市场主体信息备案

字段名称类型长度（Byte）是否必填描述

enterpriseCode