DB31_T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分：数据接口.docx

IcS35.240.99CCS1.7«DB长江三角洲区域地方标准DB31/T310024.32024DB32/T310024.32024DB33/T310024.32024DB34/T310024.32024长三角地区食品和食用农产品信息追溯第3部分：数据接口YangtzeRiverDeltainformationtraceabilityforfoodandedibleagriculturalproductsPart3:Datainterface2024-05-17发布2024Sol实施上海市市场监督管理局江苏省市场监督管理局发布浙江省市场监督管理局安徽省市场监管理局目次前三I引言Il1的用12规范性引用文件I3术语和定义14 缩略i5.I5 数据接口技术要求26数提结构37服务功能类型48接口安全4Wt求A（费料性长三角食品安全侑息迨潮平台数据接IJSON格式数据示例5本文件按照GB/T1.12020标准化工作呼则第1部分：标腐化文件的结构和起草规则的规定起草。本文件为DB31/T310024（长三角地区食Iw和自用农产品信息i测3的第3抑分.DB31/T310024已经发布了以下部分，第I部分：通则：第2加分t数据元：一一弟3部分，数据接口.请注总本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的我任.本文件由上海市Ili场监督管理局、江苏行市场曲径管理扁、浙江行市场监密检理扁、安放省市场监仰管理后联合提出、HU井姐现实施，本文件主要起草取位：上而仪电溯源科技有限公司、上而，Ii质域和标准化研究院、上而市农业科学院、上海海关动M（物。食品构5桧疫技术中心、江苏省旗V和标准化研究院"浙江省标准化研究院，淅江铃市场监督管理数字传媒中心'阿里云计中有限公司、安敏省版量和标准化研究院.本文件主要起草人：柳凌、胡传盔.邵逸也、陈悒、阮丽芳、朱殊瑶、陵志明、淄明阳、崔诚、卜童具、陈尚宇，竹加理.章学周.侯月丽、物博、程氏、科轮，周超群、徐振、彭海涛*王献礼、齐相峰'东明华、石念、朱婕、那晶、过李辉.程端琪、李博、闻天、丁炜、呢蜕.钱文妍、骆琳、安金林、陈瘠赛.叶文俏、郭博华、杨拢琳.II本文件Fi在推动构建区域联动的食品安全信息追溯体系.DB31/T310024Ih三个部分构成.第】部分：通则.目的在于为长三角地区管AJl和自用农产品信息追潮平台建i殳工作梃供指导.一第2部分：数据元.目的在于用来准确无歧义定义长三角地区食品和食用农产品的数据元分类方式和相关数楙无信息.一第3部分：数据接口，目的花于为长三角地区食品和食川农产品信息追溯平台数据接n的设计、开一和JS用提供指导.本文件系统桢理了长三向Wl区品和食用农产品侑息追溯平台中谷个警与方在数第收张、存储.传通和共学过程，研究编制了长三角地区食品和食用农产品信息追溯平台数明报U的数据结构和数擀接口检出文件，礴保数据的互操作性、一致性和安全性。Ill310024.3-2024310024.32024f）文件型,用字符串标识，应采用data:<mediatype>jbasel,<data>的字符申格式进行拼接.其中：vmedi3iype>衣示文件的类型.例如applicMion，,pdf;<data>衣小文件二进M字节流的BasC64娱码字符率Ig）对象型，用ObjeCI表示，对应JSON中的“对象符号”；h>数用鞭，用AEly衣示.是一个或多个JSoN对象符号的集合Ii）空，用NU1.1.表示,6W6.1应对接口交换的长三角食品安全信息追溯平台追溯数据的数树象进行N装，追溯数据的数据耍由多条追溯数据构成，每一条追溯数据由遭硼替与方和追溯值元构成，总体数%结构见图1,注：图中实技表示必须包含，虚浅表示可以包含.我段上的数字表示可以包含的数I也例如：1表示可以包含I条,O.n表示可以包含。到多条数据.B1总体致飨构6.2总体数榭结构组成兀会见&I.«1总体数tatajt元索幺称i据类31是杳必m描逑迫沸数斑的数据集Array是迫温牧掂的数出段数制.由沮或多沮追沏数枢纽成遭测敌粼Object是追溯数据对效，包括词追溯等与方和一组连流单元信息Hl成，并可根据需求犷展使用其他信息追游答与方Ob.jecta追溯参与方伯息数据包括一组fr>½和含用农产品生产税西普他息对象（以期数名版nt°rprix<标曲,怡息的内容应符创）附310021.2的要求M»A长三育食品安全侑息RR平台数接口JSON格式示例A.I接口Mk批按【I地址通常他请求的UR1.地址构成.只体包含以下几个部分：域片或IP地址、端口号以及接口路径.示例：htips:域名:渊口apitraceA.2功能说明迫溯信息查询的服务接11.根据请求调用返向某个追溯码对应的追溯信息.A.3敷说明A.3.1提交方法(MCIhOd)：接收(Get).A.3.2请求头(HCadCr):1表Aj所示。«A.1WM(Header)*参数名称数搦类型是否必填描述11ppKeyString是服务增提(ftfftWlll者的凭W.Fll于标识服外接口潮用衣的身份IinestanpIhtgTi(To½接【I训用时间，采用YYYY-MMDDlhh:nn:SS的格式转化为字符布传，SignntUrgString是请求圣名.用于腌诋此次请求的合法性，由调用多极据卖际的输入杂数，并优变钊SPPSEre。和约定的笠幺。法生成的笠幺A.3.3讲求数以UR1.参数格式传输.如&A.2所示.表A.2请求数表参数名称攻搦类型是否必填描述tFaceCcdeString½追溯码PeInteger否谙求数娴的当前页码,用于支持数组仅累分页,默认为第】页sizeInteger否请求数据的何贞条数,用JjU*数组故郴分贝.次认为2。条A.3.4返回内容类型(COnUn1.Type):applicalion/json;CharSet=Ulf-8。A.3.5返回数据的参数说明.如说A.3所示.«A.3参数名称*史类里处西心以描述SSUrcrSSSHoolrtfin按U调用结果，包括以下两种结果：TnIe=接口调用成功IFaIse#RiMnfI失败.DB31T310024.32024DB32T310024.32024D33T310024.32024D634T310024.32024«A.3XSM«(«)参数名称数据类型是否必填播述codeNunber½接【】响应码，WA6StringS接口梃示信星lotaInteger是查询到的数据总条数.可用r支持数组数如分贝pageInteger返刈牧械的当前页码seizeInteger返回致蛆的条数resultArray是接“调川成功后.返何的迫测敝据的数据集enterpriseObject&ISIl词用成功后.返回的食品和食用农产品生产势西看伯息对象，有象中的参数见DB31/T310024.2中第6炊的妮定productObject迫溯信息中的食拈和食用农产品她础信息对象,时象中的年数见MUIZT310024.2中第7章的规定productionObjecta.追溯怡思中的食品和食用农产品生产信恩对象的数凯，对做中的ttl>B31T310024.2中第8中的规定circulationArray否追潴信包中的食品和食用农产&流通信总对象的效俎,Qi信息对象中的第数见D3T310024.2中第9章的规定inspectionArrayS追海侑B中的食瞌和食用我产小抽检信息对象的效俎,抽检信息对象中的参数见)B3"f31002-1.2中第10章的规定A.4请求示例请求的消息示例参见图AJ。谙求方渴Gct1.R1.ihttps:/w.nydomain.con,aitrace?tracoCode=010690123456789210999999请求头；ap>KeyZakOOOOIiSMtKtaitp:202S-05-31T09:09:09SignHUIrXxXXXXXXXXXSA.1请求的谪息示例A.5返回示例返回的解密后的消息明文示例参见图A,2.*suecess*!irue.*code*:200.*tota200*page*:!,3-20*result*:enterprise*:("enlorpriSRNaDe.:上海市XXXX有Ri公司二*enterpriseTradcark*:*.hJxxx*“创HerPriSeTyPer*0*,u11iSCID*:*9131(KI(J(I(100oOOWX>X"-1icNo*rjY00(XXXW000000,*certPicturc*:*data:npplication/jpcgzbasc6l,dk8234kIjOksjdfkl23iosdf=*.*cerIEffectiveBate*:"2020-01-0CertExpiryDate*:*2030-01-O,*IegMlRcfpresentative*:*jxx*."supervisoryAgency":"XXX街道市场监首所二*scope*:h-跖生产、ifiVP-,addressw:,黄浦区XXX路XXX号*contactPersn*:张xx"ConuctPhone*:m1390000000*1ea1PersonType*:"0"*establiShnentDate*:*2020-01-0I”,*lxj5inessliccnsePicturc*:*datn:npplic»tioajpcgjbosc6,lldk8234kIjksjdfk123iosdf",*registeredd<iress*:"黄浦KXXK路KXK号”"rcgi*l11iOiMuihcriIy":"黄浦区市场Ifi将管理局”，"buyirun*MDm1"批发*certificateStatus*:11.“product":("producIiclnNanC饮1R","producorXamo":"生产厂ffA*,*standard*r*500n*shelf1.ife*:180.*catego11*<6*-barcode-:06901234567892w.*,cert*z*,1234578*ccrtf,icturc*:*data:11pp1icntion/jpeg;bosc64,dk823lkljOksjdt*ki23iosdf-*1.production*:("productionDale":"2022-01-01，-batChNvnbcr”:*2022010."origin':*Jt售市*ccrtificatio11Pictrc*:*dat<:<ipp)icntion/jpeg:b(asc64,dk8234klj0ksjdfkl23iosdf-*certNoOfOriin*:PDZCM)(MXM"*certNcOfOriginPicture*:*data:<ipplication/jpeg;base64,dk8234kIjOksjdfk123iosdf三*,"ClW:"Cl(MOCHXX>1”*ClQPicture*:*data:application/jpeg:base64.dk8234kIjOksjdfkl23iosdf=*.*quarantIneInstitution":“检疫机构A"*cert>0fQuarantinex:YZSOOOOOI*.*c<rt)0tQuarantnePictu!e*datarapplicationjug!base61.dk8231kijksjdfkl23>df=*t*cxccutivcSundard*:*GB/1XX)1.XXX*J*circulation*:("quantity*:1000"unit":"吨"*saleDate*r2022-02-0CUStoficrNnne*:“江苏得阳京市XXXX有41公司;*cstoncrAddr*:"江苏省陶京市XXX路XXX号.，*custODCrTCl3WI000W0二"uniSCID”(9131(XXKlOooOD(XXWX:*1icNo*:*JV(XXKI000IM>00(KI0*.*inspection*:(*<nlerriAeNamer"被抽样单位名旅A".*uniSCID*:*9l31(XXW00000(XX)lX*"address”抽样地点工"province，上海中”,"city":"上一市二"county。：”黄浦区“，*sa11p1eNa11e*:"饮料*,-category*："食品大类、*subcaegcries'食品亚类""SanpleSiandanT:"样fi规格”，"baichNumbor"样品批号*prodctiOnDate*/2022-01-01*checkTitt2022-02-0*rcportlbtc*:*202202H)5*,*producerNaue*:"标识生产企业名称二"prodUCerAddreT标识生产企业地及，*reportNuber*:&XW000。OoOX二*checkltew*:"校测项目A"*sUndardVlc*j*3.0-5,0*"inseCtVaIUe":实际检测代H.1"*inspectiOnResuIIs*:*!*.BBM2回前以代当示例(枚)E631r310024.a-2024DB32T310024.3-2024d3310024.3-2024DKVT31002C32024*inspectionAgency*:"上海检测机构R"*enterprise*:* enterpriSCNaBk:"上海市XKXX有限公司* enterpriScTrodcnnrk*:"上海XXX”,enterpriseType*:-0*uniSCID*r9131000XXXW00001X* 1icNo":*JYOOOOOOOOOOOOO* certPicture:*data:alication/Jpeg：t>ae64,dk8231klJOksjdfld23ios&df=*CeriEffectiMDaIJ:-2020-01-O*certExpirylktc*:*2030-0l-0,* 1ega1Representative*:"张五x."supccisoryAgcncy":"XXX街道巾场监管所，'sc3×:“优品生产、播鸨”* a<i<irtss*:"黄浦区KXX路XXX号"* ContactPcrson*:"张XX”* c<xUctPhonc*门3«KXKKKI02'* IcgnIPcrsonTypcxr:*0*"esiabliShmeniDfHe":"202（三）I0二*,business1.icensePicture*r*datazapplication,/jpebaso64,dk8234klj0ksjdfk123iosdf=*>.rogiStercdAddrcss":"黄浦区XXX路XXX号”，* regiJnrSHEnAUlhmiIyT“黄浦区市场监怦管理局二business½xlel"Jflt!”“ceriificateSiaius”:1product*:*PrCdMtIonName"饮料A*."producer。碇"："生产厂商A”,*standard"50011“shelf1.if:180ecategory*:-6*.*l>arcode*:690123'1567892*certNo*r12345678*.*ccrtPicture*:*data:applicationjpegjbase64,dk8234kIjOks.jdfkl23iosdf=*p×luciion*:*prodctiOnIbte":*2022-01H)1*"baichXiMkr":"20220101”A.2返回潮代码示例（续）1DT"origin":"上海市"，certificationPicture*:*d<it<>:nppIiention/jpeg:bosc64,dk823妹IjOksjdfkI23iosdf",，P，,>zooooor.*,certfriginPiciure*:"data:HPPlicatioJpeg:base64vdk82Mk1JOksjdfk12Siosdf=*”CIQNo*<CKXX00)01*ClQf,dure*:*<iata:applicalion/jfxgbMe64tdk82S1kIjksj<ifk123iosdf=*,*Quarantinelnstitution":'f技机构A”*certNoOfQuarantine-:JYZSOOOOO.*c<?rtN<)OfQuarantinuPicture*:*faia:a1ical沁n/jp皑；ba*c6l,<lk821kIJOksjdfIc123i<>df=*,"executiveStandard,:*GBTXXXXKX*J."circulation”:(*quantity*:1000,wunit-Hi*sald>ate*r2022-02-0rCustonerName*:"江苏省苏州市有限公司”,"cum“im”AddU江苏省苏州市XXX路XXX号"cusUxnerTel*:*i8(XW00000*.*uniSCID*:-913100000000000*hcNo*：*jvoo(xxxooooo*,*inspection*:ZmerPriSCNamZ”被抽样值位名称V.*uniSCID-9i31(XXX000000002X“水1加。55'；抽样地由""province:"上海市*-Cil厂上褥市二“county"：“黄浦IXJ*sanipk?Naiw*:*ttl4A""Mlogory":"食品大类"*subcategorirs':"作品亚类"，*sanplcSt11d11rd*:“样品规格”,*batcWVmbcr”;'样品批号'，*prtciuciionl>ae*:*2022-01-01*.*checkTi三:"2022-02-01”.*refrU)ate*/2022-02-05*“producerm、”标识生产企业名称“，“prodUCerAddrcss”J标IR生产企业地址”,reportXunber*SNOOOOOOOOOX*.*chrckltrm-<fMJ5!*.erStandardValue*:-3.0-5.Ow>“insportElu。.："实际检测位1.“inspcctionKrxuItSm*i11specti<xAs<j11cy":"上海检测机WSA.2返回消息代当示例(«)A.6接口应码说明接口响应码见衣A.4.*A.4接口应码及状态说明响应吗状态说明200服务器已成功处理请求40】未荻得登录授权或今牌失效403服务器拒绝谙求MM服务JB找不到请求的接口成页面500服务!S遇到错误，无法完成讲求502服务戏作为网关或代理.从上游服务拓收到无效响应503服务器Hflt无法使用(由于招我或件机雉护)5(MJH务器作为网关或代理.但是没有及时从卜.的服务磔收到请求