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

1

DB53/TXXXX.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)configurationaccessprotocol(XCAP))

3术语和定义

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

3.1

数据接口datainterface

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

3.2

接口协议interfaceprotocol

需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体内容等，确定通信程序发送消息和接收消息的规则。

3.3

消息头MessageHeader

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

3.4

安全认证securitycertificate

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

3.5

“名称/值”对name/valuepair

2

DB53/TXXXX.3—2022

JSON的数据存储格式，“名称/值”对组合中的名称写在前面双引号中，值写在后面双引号中，中间用冒号隔开，“名称/值”对之间由逗号分隔。

3.6

追溯码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基本要求

5.1.1接口要求

接口通过服务调用实现信息交换，应符合下列要求：——采用符合GB/T7408规定的日期类型；

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

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

5.1.2容错要求

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

5.2接口协议

接口协议方式包括：

——采用基于HTTPS传输协议的RESTFul接口方式；——采用JSON格式报文打包方式。

5.3消息头基本参数

5.3.1安全认证接口Header参数

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

3

DB53/TXXXX.3—2022

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

参数名称

参数描述

Authorization

接口授权

（其余字段）

采用默认值

5.3.2业务交互接口