DB44-T 2601.4-2025 冷链食品追溯 第4部分：数据共享与交换接口规范

ICS35.240.9944Coldchainfoodtraceability—Part4:DatasharingandIDB44/T2601.4—2025前言 12规范性引用文件 13术语和定义 14缩略语 15基本要求 16接口协议 17数据共享和交换要求 3附录A（资料性）数据交换共享请求JSON示例 5附录B（资料性）数据交换成功返回JSON示例 6附录C（资料性）数据交换失败返回JSON示例 7参考文献 8DB44/T2601.4—2025本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB44/T2601《冷链食品追溯》的第4部分。DB44/T2601已经发布了以下部分：——第1部分：电子追溯凭证参考格式；——第2部分：集中仓管理要求；——第3部分：交换数据集；——第4部分：数据共享与交换接口规范；——第5部分：信息分类与编码规则；——第6部分：统计指标。请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。本文件由广东省市场监督管理局（食品经营安全监管）提出、归口，并组织实施。本文件起草单位：广州软件应用技术研究院、广州中科易德科技有限公司。本文件主要起草人：袁敏夫、李引、董雯雯、林淑英、廖娟、钟百川、谭教珠、杨世峰、何川、何维、王一龙、肖景贤、刘东成、孙微微、郑翔蔚。DB44/T2601.4—20251冷链食品追溯第4部分：数据共享与交换接口规范本文件规定了冷链食品追溯中数据接口协议以及数据共享与交换的要求。本文件适用于企业系统、地市监管系统与广东省冷链食品追溯系统之间数据的对接与传输。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T11457信息技术软件工程术语GB/T35295信息技术大数据术语GB/T36345信息技术通用数据导入接口GB/T38672信息技术大数据接口基本要求GB/T43195进口冷链食品追溯追溯系统开发指南3术语和定义GB/T11457、GB/T35295界定的术语和定义适用于本文件。4缩略语下列缩略语适用于本文件。JSON：JS对象标记（JavaScriptObjectNotation）HTTPS：安全超文本传输协议（HyperTextTransferProtocolSecure）5基本要求5.1数据安全性数据传输和认证过程中应采用可靠加密方案，宜使用国密系列算法。5.2数据可靠性传输过程应通过有效的校验机制验证数据包的完整性和正确性。5.3数据可拓展性接口设计应具备灵活性，能够适应数据量与业务需求的增长，支持横向扩展及兼容未来技术升级。6接口协议DB44/T2601.4—20252数据通信基于TCP/IP协议和HTTPS协议，并符合GB/T36345的要求。包括以下情况：a)建立连接：采用HTTPS通信方式，进行端口监听，准备接收连接请求，并根据业务需求进行数据传输，传输结束后断开网络；b)超时重发：一条指令发出后，在规定时间内未收到回应，则认为超时；超时后应重发，重发3次后，仍未收到回应，则认为通讯失败，应自动重建连接。超时时间可根据具体情况自行设定；c)通信周期：支持被动传输和主动定时传输两种数据传输模式，主动定时传输周期可从5min到24h灵活配置。6.2接口协议数据结构6.2.1数据包组成接口协议数据包的组成应符合图1的规定。其中实体数据为经过加密的JSON格式数据，加密后以ASCII码的格式进行传输，其他数据明码传输。图1数据包的组成6.2.2数据包的结构数据包的结构见表1。表1数据包的结构6.2.3实体数据的结构实体数据的结构见表2。DB44/T2601.4—20253表2实体数据的结构7数据共享和交换要求数据共享应符合以下要求：a)数据共享以WEB服务等方式提供，参照GB/T36345和GB/T38672的要求进行；b)数据共享服务的设计、封装、开发参照GB/T43195的要求进行。7.2数据交换方式数据交换参照GB/T43195的要求进行，分为以下三个阶段：a)数据使用方通过HTTPS向数据提供方发起数据交换请求；b)数据提供方收到数据交换请求，解析数据报文，进行校验后对合法数据进行发送，非法数据则发送错误代码；c)数据使用方接收数据并存储，返回一个数据报文，数据提供方根据返回数据报文判断本次数据交换是否成功。7.3数据交换与内容格式数据交换的内容采用JSON作为数据交换的媒介。7,4数据交换请求7.4.1数据交换请求JSON格式数据交换请求JSON格式应包含以下参数：a)accessToken：调用接口的令牌。登陆成功后，返回一个32位的Hash字符串；b)timestamp：接口使用方发出请求的客户端时间（采用东八区系统时间UTC/GMT+08:00）；c)totalNum：表示数据交换所携带的记录数量；d)data：为JSON数组，存放交换数据。7.4.2数据交换请求示例可参见附录A。7.5数据交换返回7.5.1数据交换返回JSON格式数据交换返回JSON格式包括以下信息：a)errorCode：为错误代码，表明数据交换失败的原因。当数据交换成功时，该参数为0；当数据交换失败时，该参数为自定义的错误代码；DB44/T2601.4—20254b)errorMessage：为返回结果信息，描述数据交换出错的具体情况。当数据交换成功时，该参数为空值；当数据交换失败时，该参数为自定义的错误原因；c)success：标志此次数据交换是否成功。成功为true，失败为false；d)data：当数据交换成功时，则data参数为空值；当数据交换失败时，data参数存放交换失败的数据。7.5.2数据交换返回示例可参见附录B和附录C。DB44/T2601.4—20255数据交换共享请求JSON示例下面给出数据交换共享请求的JSON示列,见图A.1。accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001}图A.1数据交换请求JSON示例DB44/T2601.4—20256数据交换成功返回JSON示例下面给出数据交换成功返回JSON示例,见图B.1。{}图B.1数据交换成功返回JSON示例DB44/T2601.4—20257数据交换失败返回JSON示例下面给出数据交换失败返回JSON示例，见图C.1。{}图C.1数据交换失败返回JSON示例DB44/T2601.4—20258参考文献[1]GB/T43195—2023进口冷链食品追溯追溯