《肉品溯源数据接口规范》DB4403T 582—2025.docxVIP

ICS 35.240.60

CCSX07

DB4403

深 圳 市 地 方 标 准

DB4403/T582—2025

肉品溯源数据接口规范

Specificationformeattraceability datainterface

2025-01-15发布 2025-02-01实施

深圳市市场监督管理局发布

DB4403/T582—2025

目 次

II

1

范围

1

2

规范性引用文件

1

3

术语和定义

1

4

缩略语

1

5

接口方法及调用说明

1

5.1

接口传输要求及对接流程

1

5.2

数据类型

2

5.3

数据接口

3

附录A（资料性）

数据接口应用示例

8

A.1

凭据Token接口的应用示例

8

A.2

同步肉品溯源数据接口的应用示例

9

A.3

查询动检证核验结果接口的应用示例

11

A.4

同步肉品溯源数据并核验动检证接口的应用示例

12

附录B（资料性）

动物代码表

15

附录C（资料性）

产品代码表

17

附录D（资料性）

产品类型代码表

18

参考文献

19

I

DB4403/T582—2025

前 言

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

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

本文件由深圳市市场监督管理局提出并归口。

本文件起草单位：深圳市标准技术研究院、深圳市市场监督管理局、供广深圳肉类智能交易市场有限公司。

本文件主要起草人：李广斌、陈利平、陈伟峰、周哲、刘浩、郭静文、苏晓润、李思璁、郑文科、靳恒宇、李佩霖、陈瑜、吴岳、练晓、孙勇。

II

DB4403/T582—2025

肉品溯源数据接口规范

范围

本文件规定了调用肉品（批发）溯源系统的数据接口进行数据交换的接口方法和调用说明。

本文件适用于调用肉品（批发）溯源系统的数据接口的集成开发。

规范性引用文件

本文件没有规范性引用文件。

术语和定义

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

3.1

数据接口 datainterface

以电子文件的形式实现，计算机软件系统之间传送数据、交换信息的接口。

[来源：GB/T42940—2023,3.3]

3.2

数据对接方 datadockingparty

数据接口调用者，与肉品（批发）溯源系统进行数据交换的单位。

缩略语

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

API：应用程序编程接口（ApplicationProgrammingInterface）

HTTP：超文本传输协议（HyperTextTransferProtocol）

JSON：对象简谱（JavascriptObjectNotation）

接口方法及调用说明

5.1 接口传输要求及对接流程

5.1.1接口使用JSON传输数据，技术接口对接示意如图1所示。肉品数据对接方系统获取访问令牌，访问验证通过后，根据预先定义好的接口方法，进行肉品溯源数据交换，数据接口应用示例见附录A。

注：肉品溯源数据主要包含分销台账数据、动物检疫合格证明（以下简称“动检证”）数据等。

5.1.2 数据交换分为三种方式：

数据对接方系统输入参数，同步肉品溯源数据后，肉品（批发）溯源系统（以下简称“溯源系统”）自动实时返回溯源数据同步结果；

数据对接方系统主动进行动检证核验结果查询；

1

DB4403/T582—2025

数据对接方系统输入参数，同步肉品溯源数据后，溯源系统自动实时返回溯源数据同步结果和动检证核验结果。

注：Token指邀请、登录系统的临时令牌。

图1 技术接口对接示意图

5.2 数据类型

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

字符型；

整数型；

浮点型；

布尔型；

日期型；

对象型。

2

DB4403/T582—2025

5.3 数据接口

5.3.1 凭据Token调用接口

接口说明

接口说明如下：

接口名称：接口访问授权调用接口；

接口描述：用于获取业务接口的访问调用凭据；

HTTP请求方式：GET；

接口标识符：GetToken。

接口输入参数及说明

凭据Token调用接口的输入参数及说明见表1。

表1

凭据Token调用接口的输入参数及说明

输入参数

数据类型

是否非空

说明

Params

appId

字符型

是

应用码

appSecret

字符型

是

应用授权码

接口返回参数及说明

凭据Token调用接口的返回参数及说明见表2。

表2

凭据Token调用接口的返回参数及说明

返回参数

数据类型

是否非空

说明

success

布尔型

是

调用结果，若为“true”，表示成功；若为“false”，表示