《广东省冷链食品追溯 数据共享与交换接口规范》（送审稿）

ICS35.240.99CCSL6744GuangdongcoldchainfoodtIDB44/TXXXX—XXXX前言 2规范性引用文件 3术语和定义 4缩略语 5基本要求 5.1数据安全性 5.2数据可靠性 5.3数据可拓展性 6接口协议 6.1通讯协议 26.2接口协议数据结构 27数据共享和交换要求 37.1数据共享要求 37.2数据交换方式 37.3数据交换与内容格式 37.4数据交换请求 37.5数据交换返回 3附录A（资料性）数据交换共享请求JSON示例 5附录B（资料性）数据交换成功返回JSON示例 6附录C（资料性）数据交换失败返回JSON示例 7参考文献 8DB44/TXXXX—XXXX本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。本文件由广东省市场监督管理局提出。本文件由广东省市场监督管理局归口。本文件起草单位：广东省市场监督管理局、天河区市场监督管理局、广州执信网络技术有限公司、广州中科易德科技有限公司、广州软件应用技术研究院、珠海复旦创新研究院。本文件主要起草人：袁敏夫、李引、董雯雯、林淑英、廖娟、钟百川、谭教珠、杨世峰、何川、何维、王一龙、肖景贤、刘东成、孙微微、郑翔蔚、王俊宇、高自立、李露露。1DB44/TXXXX—XXXX广东省冷链食品追溯数据共享与交换接口规范本文件规定了广东省冷链食品追溯中的数据传输基本要求、数据接口协议以及数据共享与交换要求。本文件适用于企业系统、地市监管系统与广东省冷链食品追溯系统之间数据的对接与传输。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接口协议2DB44/TXXXX—XXXX6.1通讯协议数据通信基于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。3DB44/TXXXX—XXXX表2实体数据的结构标识了发送者的数据序号，应答时，本项内容应按根据数据序号，内容不同，数据内容是经过加密的JSON格式数据，加密后以ASCII码的格式进行传7数据共享和交换要求7.1数据共享要求数据共享应符合以下要求：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格式包括以下信息：4DB44/TXXXX—XXXXa)errorCode：为错误代码，表明数据交换失败的原因。当数据交换成功时，该参数为0；当数据交换失败时，该参数为自定义的错误代码；b)errorMessage：为返回结果信息，描述数据交换出错的具体情况。当数据交换成功时，该参数为空值；当数据交换失败时，该参数为自定义的错误原因；c)success：标志此次数据交换是否成功。成功为true，失败为false；d)data：当数据交换成功时，则data参数为空值；当数据交换失败时，data参数存放交换失败的数据。7.5.2数据交换返回示例可参见附录B和附录C。5DB44/TXXXX—XXXX（资料性）数据交换共享请求JSON示例下面给出数据交换共享请求的JSON示列,见图A.1。https://{SERVER_IP}accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001&timeContent-Type:applicat"ENT_CREDIT_CODE":"5CFC5CABA549CA9DE050A8C0DD013}图A.1数据交换请求JSON示例6DB44/TXXXX—XXXX（资料性）数据交换成功返回JSON示例下面给出数据交换成功返回JSON示例,见图B.1。{}",,图B.1数据交换成功返回JSON示例7DB44/TXXXX—XXXX（资料性）数据交换失败返回JSON示例下面给出数据交换失败返回JSON示例，见图C.1。{"errorMessage":"JSON数据验证}图C.1数据交换失败返回JSON示例8DB44/TXXXX—XXXX参考文献[