長三角食品安全信息平臺追溯數(shù)據(jù)接口JSON格式數(shù)據(jù)示例

長三角食品安全信息平臺追溯數(shù)據(jù)接口JSON格式數(shù)據(jù)示例接口地址接口地址由請求的URL地址，一般由域名或IP、端口號、接口路徑組成。https://{域名}:{端口}/api/trace功能說明追溯信息查詢的服務接口。根據(jù)請求調用返回某個追溯碼對應的追溯信息。參數(shù)說明提交方法(Method)：Get。請求頭(Header)：如表A.1所示。請求頭(Header)表參數(shù)名稱數(shù)據(jù)類型是否必填描述appKeyString是服務端提供給調用者的憑證，用于標識服務接口調用者的身份timestampDateTime是接口調用時間，采用YYYY-MM-DDThh:mm:ss的格式轉化為字符串傳輸signatureString是請求簽名，用于驗證此次請求的合法性，由調用者根據(jù)實際的輸入?yún)?shù)，并憑密鑰（appSecret）和約定的簽名算法生成的簽名請求參數(shù)以URL參數(shù)格式傳輸，如表A.2所示。請求參數(shù)表參數(shù)名稱數(shù)據(jù)類型是否必填描述traceCodeString是追溯碼pageInteger否請求數(shù)據(jù)的當前頁碼，用于支持數(shù)組數(shù)據(jù)分頁，默認為第1頁sizeInteger否請求數(shù)據(jù)的每頁條數(shù)，用于支持數(shù)組數(shù)據(jù)分頁，默認為20條返回內容類型(Content-Type)：application/json;charset=utf-8。返回數(shù)據(jù)的參數(shù)說明，如表A.3所示。表A.3返回參數(shù)表參數(shù)名稱數(shù)據(jù)類型是否必填描述successBoolean是接口調用結果，包括以下兩種結果：True=接口調用成功；False=接口調用失敗。codeNumber是接口響應碼，見A.6messageString否接口提示信息totalInteger是查詢到的數(shù)據(jù)總條數(shù)，可用于支持數(shù)組數(shù)據(jù)分頁pageInteger是返回數(shù)據(jù)的當前頁碼sizeInteger是返回數(shù)據(jù)的條數(shù)表A.3返回參數(shù)表（續(xù)）參數(shù)名稱數(shù)據(jù)類型是否必填描述resultArray是接口調用成功后，返回的追溯數(shù)據(jù)的數(shù)據(jù)集enterpriseObject是接口調用成功后，返回的食品和食用農(nóng)產(chǎn)品生產(chǎn)經(jīng)營者信息對象，對象中的參數(shù)應符合DB31/T310XX.2中第6章的規(guī)定productObject否追溯信息中的食品和食用農(nóng)產(chǎn)品基礎信息對象，對象中的參數(shù)應符合DB31/T310XX.2中第7章的規(guī)定productionObject否追溯信息中的食品和食用農(nóng)產(chǎn)品生產(chǎn)信息對象的數(shù)組，對象中的參數(shù)應符合DB31/T310XX.2中第8章的規(guī)定circulationArray否追溯信息中的食品和食用農(nóng)產(chǎn)品流通信息對象的數(shù)組，流通信息對象中的參數(shù)應符合DB31/T310XX.2中第9章的規(guī)定inspectionArray否追溯信息中的食品和食用農(nóng)產(chǎn)品抽檢信息對象的數(shù)組，抽檢信息對象中的參數(shù)應符合DB31/T310XX.2中第10章的規(guī)定請求示例請求的消息示例參見表A.4。表A.4請求的消息示例請求方法：GetURL：/api/trace?traceCode=010690123456789910999999請求頭:appKey:ak00001timestamp:2023-05-31T09:09:09signature:xxxxxxxxxxx返回示例返回的解密后的消息明文示例參見A.5。表A.5返回消息代碼示例表{"success":true,"code":200,"total":200,"page":1,"size":20,"result":[{"enterprise":{"enterpriseName":"上海市xxxx有限公司","enterpriseTrademark":"上海xxx","enterpriseType":"0","uniSCID":"91310000000000000000","licNo":"JY00000000000000","certPicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=",表A.5返回消息代碼示例表（續(xù)）"certEffectiveDate":"2020-01-01","certExpiryDate":"2030-01-01","legalRepresentative":"張xx","supervisoryAgency":"xxx街道市場監(jiān)管所","scope":"食品生產(chǎn)、銷售","address":"黃浦區(qū)xxx路xxx號","contactPerson":"張xx","contactPhone":,"legalPersonType":"0","establishmentDate":"2020-01-01","businessLicensePicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=","registeredAddress":"黃浦區(qū)xxx路xxx號","registrationAuthority":"黃浦區(qū)市場監(jiān)督管理局","businessModel":"生產(chǎn)、批發(fā)","certificateStatus":"1"},"product":{"productionName":"飲料A","producerName":"生產(chǎn)廠商A","standard":"500ml","shelfLife":"180","category":"5","barcode":"6930000000001","certNo":"12345678","certPicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf="},"production":{"productionDate":"2022-01-01","batchNumber":"20220101","origin":"上海市","certificationPicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=","certNoOfOrigin":"CDZ000001","certNoOfOriginPicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=","CIQNo":"CIQ0000001","CIQPicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=", "quarantineInstitution":"檢疫機構A", "certNoOfQuarantine":"JYZS000001",

表A.5返回消息代碼示例表（續(xù)） "certNoOfQuarantinePicture":"data:application/jpeg;base64,dk8234kljOksjdfkl23iosdf=", "executiveStandard":"GB/TXXXXXX" }, "circulation":[ { "quantity":1000, "unit":"噸", "saleDate":"2022-02-01", "customerName":"江蘇省南京市xxxx有限公司", "customerAddr":"江蘇省南京市xxx路xxx號", "customerTel":"138000000000", "uniSCID":"91310000000000000X","licNo":"JY00000000000000" } ], "inspection":[ { "enterpriseName":"被抽樣單位名稱A", "uniSCID":"91310000000000000X", "address":"抽樣地點", "province":"上海市", "city":"上海市", "county":"黃浦區(qū)", "sampleName":"樣品名稱A", "category":"食品大類", "subcategories":"食品亞類", "sampleStandard":"樣品規(guī)格", "batchNumber":"樣品批號", "productionDate":"2022-01-01", "checkTime":"2022-02-01", "reportDate":"2022-02-05", "producerName":"標識生產(chǎn)企業(yè)名稱", "producerAddress":"標識生產(chǎn)企業(yè)地址", "sampleNumber":"SN000000000X", "checkItem":"檢測項目A", 表A.5返回消息代碼示例表（續(xù)）"standardValue":"3.0～5.0", "inspectValue":"實際檢測值4.1", "inspectionResults