DB32T 3407-2018 食品安全電子追溯標識解析服務(wù)數(shù)據(jù)接口規(guī)范

備案號：60243-2018DB32Interfacespecificationofidentificationresolutionserviceforfoodsafetyele江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布I 1 1 1 2 3 3 4 4 4 4 5 5 5 5 6 7 7 8 9 本標準按照GB/T1.1-2009給1食品安全電子追溯標識解析服務(wù)數(shù)據(jù)接口規(guī)范本標準適用于食品安全電子追溯標識解析服務(wù)的接凡是不注日期的引用文件，其最新版本（包括所有的修改單）RFC4627JSON格式定義(Theapplication/JSONmediatypeforjavas數(shù)據(jù)目錄服務(wù)datacatalog2DCS網(wǎng)元datacatalogservi追溯代理traceabilitySP網(wǎng)元SupervisorPlatfo接收IQS網(wǎng)元上報的追溯數(shù)據(jù)，支撐政府監(jiān)管人4縮略語DNS：域名服務(wù)(DomainNameServicDCS：數(shù)據(jù)目錄服務(wù)(DataCatalogServGTIN：全球貿(mào)易項目代碼(GlobalTradeItemNIQS：信息查詢服務(wù)(InformatIRS：標識解析服務(wù)(IdentificationRJSON：JS對象標記(JavaScriptObjectNotaRFID：射頻識別(RadioFrequencyIdentificSP：監(jiān)管平臺(SupervisorPlURL：統(tǒng)一資源定位符(UniformResourceLocator)3URN：統(tǒng)一資源名稱(UniformResourceNamXML：可擴展標記語言(ExtensibleMarkupLangEU網(wǎng)元監(jiān)管平臺數(shù)據(jù)交換接口數(shù)據(jù)上報接口食品質(zhì)量安全監(jiān)管平臺各市監(jiān)管平臺……追溯代理IRS網(wǎng)元Web/微信DCS網(wǎng)元SP網(wǎng)元EU網(wǎng)元監(jiān)管平臺數(shù)據(jù)交換接口數(shù)據(jù)上報接口食品質(zhì)量安全監(jiān)管平臺各市監(jiān)管平臺……追溯代理IRS網(wǎng)元Web/微信DCS網(wǎng)元SP網(wǎng)元IQS網(wǎng)元IQS數(shù)據(jù)傳輸接口企業(yè)平臺/APP服務(wù)查詢平臺IRS解析查詢接口DCSIRS標識管理接口DCS查詢接口IQS查詢接口DCS標識管理接口DCS事件登記接口CUCU網(wǎng)元追溯代理應(yīng)以用戶發(fā)起的追溯請求為觸發(fā)，代替用戶完成追溯系統(tǒng)的內(nèi)部5.2基本服務(wù)功能4口上承載的協(xié)議棧應(yīng)為HTTP或HTTPS協(xié)議棧，數(shù)據(jù)接口應(yīng)使用基于HTTP/HTTPS協(xié)議的JSON格式的消息體基于服務(wù)的方式定義數(shù)據(jù)接口的使用方法。服務(wù)響應(yīng)流程使用了“請求-Request”“指示服務(wù)器-Indication”“響應(yīng)-Response”“確認-Confirm”四條服務(wù)原語，原語的順服務(wù)器客戶端請求-RequestHTTP請求-RequestRequest消息指示-Indication響應(yīng)-響應(yīng)-Response確認-Confirm確認-ConfirmHTTPResponse消息b)IRS解析查詢接口。5Number請求接口應(yīng)通過RFC1945或RFC2616中規(guī)定的HTTP請求，使用Get或者Post方法調(diào)用食品電子追溯目錄服務(wù)接口。請求接口將請求參數(shù)按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中請求接口調(diào)用成功或失敗以后，IRS網(wǎng)元應(yīng)以RFC4825中規(guī)定的XML或R處理結(jié)果放置在HTTP的Response消息的Body中，返回給調(diào)用者。HTTP的Response消息應(yīng)符合RFC1945追溯代理網(wǎng)元應(yīng)通過IRS標識解析接口向IRS網(wǎng)元發(fā)送需要解析的物品標識，并從IRS網(wǎng)元獲得該被6MessageName是是否是否否否是被追溯的資源編碼所歸屬的是否DCS網(wǎng)元應(yīng)先通過DCS網(wǎng)元登陸接口對DCS網(wǎng)元進行認證，并由IRS網(wǎng)元授予DCS網(wǎng)元相應(yīng)的權(quán)限。IRS網(wǎng)元在對DCS網(wǎng)元的用戶名和密碼認證通過以后，應(yīng)將會話ID返回給DCS，后續(xù)DCS通過會話ID與IRS網(wǎng)元進行數(shù)據(jù)交互。IRS網(wǎng)元應(yīng)刪除長期不用的空閑會話ID，空間會話ID的保留時間由IRS網(wǎng)元的管理該接口名稱為IRS_DCS_Login，DCS網(wǎng)元登陸請求接口參數(shù)見表4，DCS網(wǎng)元登陸響應(yīng)接口參數(shù)見表MessageName是Name是是7是是DCS網(wǎng)元應(yīng)通過DCS網(wǎng)元注冊接口向IRS網(wǎng)元注冊DCS網(wǎng)元的基礎(chǔ)信息。該接口應(yīng)由DCS網(wǎng)元發(fā)起，由DCS網(wǎng)元注冊請求接口參數(shù)見表6，DCS網(wǎng)元注冊響應(yīng)接口參數(shù)見表7。MessageName是是Node是是是是DCS網(wǎng)元應(yīng)通過IRS注冊接口實現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元請求標識注冊。該接口示例參見附錄B.4。8MessageName是是所注冊的標識列表，可包含是是是是DCS網(wǎng)元應(yīng)通過IRS標識更新接口向IRS網(wǎng)元發(fā)起請求標識更新請求，修改IRS數(shù)據(jù)庫中標識的相關(guān)MessageName是是是是是9是DCS網(wǎng)元與IRS網(wǎng)元之間可通過IRS標識刪除接口，實現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元發(fā)起請求刪除，刪除某個IRS標識刪除請求接口參數(shù)見表12,MessageName是是是是是是是識B.1.1HTTP-Request消息的J"MessageName":"IRS_ID_Resolute","ObjectCode1":"06900413431157","ObjectCode2":","Role":"EndUser","GTIN":"06900413431157","StructuB.1.2HTTP-Response消息"Status":"Succ","SrvList":["DCSURL":"/service.asmx","EvtDetmName":"BackupDCSURL","ItemValue":"/service.asmx"},{"ItemName":"Structure","ItemValue":"GS1"},{"ItemName":"TranslatedCode","ItemValue":"urn:gbiotroot:id:obj:2009061A23.06900413431157."}]]}B.2.1HTTP-Request消息的J"MessageName":"IRS_DCS_Login","Name":"NanJingDCS-01","PasswoB.2.2HTTP-Response消息B.3.1HTTP-Request消息的JS"MessageName":"IRS_DCS_Reg","Node":"/service.asmx","S7681","Structure":"GS1","SrvList":[{"ItemName":"BackupDCSURL","ItemValue":"http://ds2.exampl/service.asmx"},{"ItemName":"Structure","ItemValue":"GS1"}B.3.2HTTP-Response消息B.4.1HTTP-Request消息的J"MessageName":"IRS_ID_Reg","codeList":[{"ID":"urn:cniotroot:id:obj:001."},{"ID":"urn:cniotroot:id:obj:002.107346."}]}ructure":"GS1","DCSURL":"/service.asmx"B.4.2HTTP-Response消息B.5.1HTTP-Request消息的J"MessageName":"IRS_ID_Upd","updateContent":"urn:cniotroot:id:obj:001.107346","Structure":"GS1","DCSURL":"/service.