ICS35.240.9944Coldchainfoodtraceability—Part4:DatasharingandIDB44/T2601.4—2025前言 12規(guī)范性引用文件 13術語和定義 14縮略語 15基本要求 16接口協(xié)議 17數據共享和交換要求 3附錄A（資料性）數據交換共享請求JSON示例 5附錄B（資料性）數據交換成功返回JSON示例 6附錄C（資料性）數據交換失敗返回JSON示例 7參考文獻 8DB44/T2601.4—2025本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件是DB44/T2601《冷鏈食品追溯》的第4部分。DB44/T2601已經發(fā)布了以下部分：——第1部分：電子追溯憑證參考格式；——第2部分：集中倉管理要求；——第3部分：交換數據集；——第4部分：數據共享與交換接口規(guī)范；——第5部分：信息分類與編碼規(guī)則；——第6部分：統(tǒng)計指標。請注意本文件的某些內容可能涉及專利，本文件的發(fā)布機構不承擔識別專利的責任。本文件由廣東省市場監(jiān)督管理局（食品經營安全監(jiān)管）提出、歸口，并組織實施。本文件起草單位：廣州軟件應用技術研究院、廣州中科易德科技有限公司。本文件主要起草人：袁敏夫、李引、董雯雯、林淑英、廖娟、鐘百川、譚教珠、楊世峰、何川、何維、王一龍、肖景賢、劉東成、孫微微、鄭翔蔚。DB44/T2601.4—20251冷鏈食品追溯第4部分：數據共享與交換接口規(guī)范本文件規(guī)定了冷鏈食品追溯中數據接口協(xié)議以及數據共享與交換的要求。本文件適用于企業(yè)系統(tǒng)、地市監(jiān)管系統(tǒng)與廣東省冷鏈食品追溯系統(tǒng)之間數據的對接與傳輸。2規(guī)范性引用文件下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T11457信息技術軟件工程術語GB/T35295信息技術大數據術語GB/T36345信息技術通用數據導入接口GB/T38672信息技術大數據接口基本要求GB/T43195進口冷鏈食品追溯追溯系統(tǒng)開發(fā)指南3術語和定義GB/T11457、GB/T35295界定的術語和定義適用于本文件。4縮略語下列縮略語適用于本文件。JSON：JS對象標記（JavaScriptObjectNotation）HTTPS：安全超文本傳輸協(xié)議（HyperTextTransferProtocolSecure）5基本要求5.1數據安全性數據傳輸和認證過程中應采用可靠加密方案，宜使用國密系列算法。5.2數據可靠性傳輸過程應通過有效的校驗機制驗證數據包的完整性和正確性。5.3數據可拓展性接口設計應具備靈活性，能夠適應數據量與業(yè)務需求的增長，支持橫向擴展及兼容未來技術升級。6接口協(xié)議DB44/T2601.4—20252數據通信基于TCP/IP協(xié)議和HTTPS協(xié)議，并符合GB/T36345的要求。包括以下情況：a)建立連接：采用HTTPS通信方式，進行端口監(jiān)聽，準備接收連接請求，并根據業(yè)務需求進行數據傳輸，傳輸結束后斷開網絡；b)超時重發(fā)：一條指令發(fā)出后，在規(guī)定時間內未收到回應，則認為超時；超時后應重發(fā)，重發(fā)3次后，仍未收到回應，則認為通訊失敗，應自動重建連接。超時時間可根據具體情況自行設定；c)通信周期：支持被動傳輸和主動定時傳輸兩種數據傳輸模式，主動定時傳輸周期可從5min到24h靈活配置。6.2接口協(xié)議數據結構6.2.1數據包組成接口協(xié)議數據包的組成應符合圖1的規(guī)定。其中實體數據為經過加密的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)數據共享服務的設計、封裝、開發(fā)參照GB/T43195的要求進行。7.2數據交換方式數據交換參照GB/T43195的要求進行，分為以下三個階段：a)數據使用方通過HTTPS向數據提供方發(fā)起數據交換請求；b)數據提供方收到數據交換請求，解析數據報文，進行校驗后對合法數據進行發(fā)送，非法數據則發(fā)送錯誤代碼；c)數據使用方接收數據并存儲，返回一個數據報文，數據提供方根據返回數據報文判斷本次數據交換是否成功。7.3數據交換與內容格式數據交換的內容采用JSON作為數據交換的媒介。7,4數據交換請求7.4.1數據交換請求JSON格式數據交換請求JSON格式應包含以下參數：a)accessToken：調用接口的令牌。登陸成功后，返回一個32位的Hash字符串；b)timestamp：接口使用方發(fā)出請求的客戶端時間（采用東八區(qū)系統(tǒng)時間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進口冷鏈食品追溯追溯