CCSL7833浙江省市場監(jiān)督管理局發(fā)布IDB33/T1417—2025本標準按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本標準的某些內(nèi)容可能涉及專利。本標準的發(fā)布機構(gòu)不承擔識別專利的責任。本標準由浙江省市場監(jiān)督管理局提出、歸口并組織實施。本標準起草單位：湖州市市場監(jiān)督管理局、浙江省質(zhì)量科學研究院、紹興市能源檢測院、浙江方圓檢測集團股份有限公司、江山市市場監(jiān)督管理局、德清縣市場監(jiān)督管理局、嘉興市市場監(jiān)督管理局、遂昌縣市場監(jiān)督管理局、浙江省市場監(jiān)督管理數(shù)字傳媒中心、蒼南縣市場監(jiān)督管理局、政采云有限公司、阿里云計算有限公司、杭州農(nóng)副產(chǎn)品物流網(wǎng)絡科技有限公司、杭州半云科技有限公司、杭州聯(lián)華華商集團有限公司、衢州市衢江區(qū)檢驗檢測中心、嘉興聚水潭智能科技有限公司。本標準主要起草人：聞雪婭、郭銳、程璐璐、潘凱凌、姚璇、邱勤麗、楊春、徐超、趙江濤、陳斌、高壯飛、潘凌駿、楊清潭、崔芳芳、鄭劍、杜志才、溫建東、過李輝、黃冠、陶煒、李博、焦站靜、萬家武、李洋、徐翔、謝曉東、周肖君、王美蓉、沈仙蘭、張雪婷、郝禾瓊、曹張華。DB33/T1417—20251食品安全追溯信息系統(tǒng)接口技術(shù)導則本標準規(guī)定了食品安全追溯信息系統(tǒng)的總體要求、接口類型、管理要求、接口報文、安全要求、接口應用、接口說明文檔。本標準適用于食品安全追溯信息系統(tǒng)接口的設(shè)計和管理。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本標準必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本標準；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本標準。GB/T7408.1日期和時間信息交換表示法第一部分：基本原則GB/T35274信息安全技術(shù)大數(shù)據(jù)服務安全能力要求GB/T38155重要產(chǎn)品追溯追溯術(shù)語IETFRFC2818TLS上的HTTP(HTTPoverTLS)IETFRFC3548Base16、Base32、Base64數(shù)據(jù)編碼（TheBase16,BasIETFRFC3629UTF-8，ISO10646轉(zhuǎn)換格式（UTF-8,atransformationformatofISO10646）IETFRFC4627JSON格式定義(Theapplicati3術(shù)語和定義GB/T38155界定的術(shù)語和定義適用于本標準。4總體要求食品安全追溯信息系統(tǒng)接口與通過服務調(diào)用所需的信息，應符合以下要求：——底層承載協(xié)議應符合IETFRFC2818的規(guī)定；——字符集應符合IETFRFC3629的規(guī)定；——日期類型應符合GB/T7408.1的規(guī)定；——圖片、文件轉(zhuǎn)換為字符串應符合IETFRFC3548的規(guī)定；——接口響應應符合IETFRFC4627的規(guī)定；——應建立接口日志記錄，能識別數(shù)據(jù)異常和追蹤交換數(shù)據(jù)情況；——發(fā)生錯誤時，接口應把詳細的錯誤代碼和錯誤信息返回給接口使用方。5接口類型食品安全追溯信息系統(tǒng)的數(shù)據(jù)接口包括數(shù)據(jù)查詢接口、數(shù)據(jù)修改接口、數(shù)據(jù)增加接口和數(shù)據(jù)刪除接口，供食品和食用農(nóng)產(chǎn)品生產(chǎn)經(jīng)營者及第三方追溯系統(tǒng)使用?！獢?shù)據(jù)查詢接口：用于數(shù)據(jù)的查詢或下載操作。2DB33/T1417—2025——數(shù)據(jù)修改接口：用于數(shù)據(jù)的修改操作?！獢?shù)據(jù)增加接口：用于數(shù)據(jù)的上報和導入操作，示例見附錄A。——數(shù)據(jù)刪除數(shù)據(jù)：用于數(shù)據(jù)的刪除操作。6管理要求食品安全追溯信息系統(tǒng)接口的管理要求包括接口測試、申請、激活、應用、維護等方面?！涌跍y試：用戶應在申請接口前獲取測試包完成接口測試。測試包應包括安全SDK，測試接口，測試密鑰等。——接口申請：完成接口測試后，用戶向食品安全追溯信息系統(tǒng)管理員提出接口申請，包括接口名稱、功能描述、接口權(quán)限、使用目的等信息?！涌诩せ睿菏称钒踩匪菪畔⑾到y(tǒng)根據(jù)用戶信息進行審核，分配企業(yè)密鑰，進行激活操作。——接口應用：完成接口激活后，用戶可根據(jù)需求開展接口應用，接口應用包括企業(yè)對接、第三方系統(tǒng)對接、物聯(lián)設(shè)備對接?！涌诰S護：食品安全追溯信息系統(tǒng)管理員負責對已發(fā)布的接口進行維護和監(jiān)控，及時處理接口相關(guān)的問題和漏洞。7接口報文請求報文食品安全追溯信息系統(tǒng)接口的請求報文由請求頭和請求體組成，采用POST方式發(fā)送。不同接口具有統(tǒng)一的請求頭，請求頭的字段及其描述應符合表1的規(guī)定。請求體的參數(shù)格式見表2，根據(jù)不同接口功能，其請求體參數(shù)不同。注：POST是HTTP協(xié)議的一種請求方式。表1請求頭格式是是4是是-是是表2請求體參數(shù)格式3頭的字段及其描述應符合表3的規(guī)定。響應體的參數(shù)格式見表4,根據(jù)不同接口功能，其響應體不同。表3響應頭格式參數(shù)名數(shù)據(jù)類型最大長度是是消息流水號4是是響應碼是響應信息是是調(diào)用當前時間戳，基于UTC時間表4響應體參數(shù)格式參數(shù)名數(shù)據(jù)類型給出參數(shù)名對參數(shù)的描述及補充說明——應符合GB/T35274的安全能力要求；——第三方請求發(fā)送到食品安全追溯信息系統(tǒng)時，平臺應進行IP白名單、簽名、防重放、調(diào)用次——安全算法應分為簽名和加密兩步驟。簽名算法對請求頭和請求參數(shù)進行SHA256簽名后轉(zhuǎn)HEX;——密鑰：128位；——初始向量：nonce格式化為16位(不足前面補0);——密鑰：128位；——初始向量：nonce格式化為16位(不足前面補0);——解密后數(shù)據(jù)：解密后字節(jié)數(shù)組轉(zhuǎn)換成UTF-8文本。4生產(chǎn)者對接信息宜包括食品或食用農(nóng)產(chǎn)品的名稱、規(guī)格、數(shù)質(zhì)量合格證明，以及生產(chǎn)者名稱、統(tǒng)一社會信息代碼等追溯信息，涉及物聯(lián)設(shè)備對接參照9.3。5DB33/T1417—2025（資料性）接口示例某生產(chǎn)企業(yè)通過調(diào)用數(shù)據(jù)上傳接口上報某產(chǎn)品的信息，包括產(chǎn)品基本信息、原料信息、配料信息、添加劑信息和檢驗信息等。請求部分示例見表A.1，響應部