《DB31_T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分：数据接口.docx》由会员分享，可在线阅读，更多相关《DB31_T 310024.3-2024 长三角地区食品和食用农产品信息追溯 第3部分：数据接口.docx（12页珍藏版）》请在课桌文档上搜索。
1、IcS35.240.99CCS1.7DB长江三角洲区域地方标准DB31/T310024.32024DB32/T310024.32024DB33/T310024.32024DB34/T310024.32024长三角地区食品和食用农产品信息追溯第3部分：数据接口YangtzeRiverDeltainformationtraceabilityforfoodandedibleagriculturalproductsPart3:Datainterface2024-05-17发布2024Sol实施上海市市场监督管理局江苏省市场监督管理局发布浙江省市场监督管理局安徽省市场监管理局目次前三I引言Il1的用12
2、规范性引用文件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场监督管理局、江苏行市场曲径管理扁、浙江行市场
3、监密检理扁、安放省市场监仰管理后联合提出、HU井姐现实施，本文件主要起草取位：上而仪电溯源科技有限公司、上而，Ii质域和标准化研究院、上而市农业科学院、上海海关动M（物。食品构5桧疫技术中心、江苏省旗V和标准化研究院浙江省标准化研究院，淅江铃市场监督管理数字传媒中心阿里云计中有限公司、安敏省版量和标准化研究院.本文件主要起草人：柳凌、胡传盔.邵逸也、陈悒、阮丽芳、朱殊瑶、陵志明、淄明阳、崔诚、卜童具、陈尚宇，竹加理.章学周.侯月丽、物博、程氏、科轮，周超群、徐振、彭海涛*王献礼、齐相峰东明华、石念、朱婕、那晶、过李辉.程端琪、李博、闻天、丁炜、呢蜕.钱文妍、骆琳、安金林、陈瘠赛.叶文俏、郭博华
4、、杨拢琳.II本文件Fi在推动构建区域联动的食品安全信息追溯体系.DB31/T310024Ih三个部分构成.第】部分：通则.目的在于为长三角地区管AJl和自用农产品信息追潮平台建i殳工作梃供指导.一第2部分：数据元.目的在于用来准确无歧义定义长三角地区食品和食用农产品的数据元分类方式和相关数楙无信息.一第3部分：数据接口，目的花于为长三角地区食品和食川农产品信息追溯平台数据接n的设计、开一和JS用提供指导.本文件系统桢理了长三向Wl区品和食用农产品侑息追溯平台中谷个警与方在数第收张、存储.传通和共学过程，研究编制了长三角地区食品和食用农产品信息追溯平台数明报U的数据结构和数擀接口检出文件，礴保
5、数据的互操作性、一致性和安全性。Ill310024.3-2024310024.32024f）文件型,用字符串标识，应采用data:jbasel,的字符申格式进行拼接.其中：vmedi3iype衣示文件的类型.例如applicMion，,pdf;衣小文件二进M字节流的BasC64娱码字符率Ig）对象型，用ObjeCI表示，对应JSON中的“对象符号”；h数用鞭，用AEly衣示.是一个或多个JSoN对象符号的集合Ii）空，用NU1.1.表示,6W6.1应对接口交换的长三角食品安全信息追溯平台追溯数据的数树象进行N装，追溯数据的数据耍由多条追溯数据构成，每一条追溯数据由遭硼替与方和追溯值元构成，总体
6、数%结构见图1,注：图中实技表示必须包含，虚浅表示可以包含.我段上的数字表示可以包含的数I也例如：1表示可以包含I条,O.n表示可以包含。到多条数据.B1总体致飨构6.2总体数榭结构组成兀会见&I.1总体数tatajt元索幺称i据类31是杳必m描逑迫沸数斑的数据集Array是迫温牧掂的数出段数制.由沮或多沮追沏数枢纽成遭测敌粼Object是追溯数据对效，包括词追溯等与方和一组连流单元信息Hl成，并可根据需求犷展使用其他信息追游答与方Ob.jecta追溯参与方伯息数据包括一组fr和含用农产品生产税西普他息对象（以期数名版ntrprixB31T310024.2中第8中的规定circulationA
7、rray否追潴信包中的食品和食用农产&流通信总对象的效俎,Qi信息对象中的第数见D3T310024.2中第9章的规定inspectionArrayS追海侑B中的食瞌和食用我产小抽检信息对象的效俎,抽检信息对象中的参数见)B3f31002-1.2中第10章的规定A.4请求示例请求的消息示例参见图AJ。谙求方渴Gct1.R1.ihttps:/w.nydomain.con,aitrace?tracoCode=010690123456789210999999请求头；apKeyZakOOOOIiSMtKtaitp:202S-05-31T09:09:09SignHUIrXxXXXXXXXXXSA.1请求的
8、谪息示例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(100oOOWXX-1icNo*rjY00(XXXW000000,*certPicturc*:*data:npplication/jpcgzbasc6l,dk8234kIjOksjdfkl23iosd
9、f=*.*cerIEffectiveBate*:2020-01-0CertExpiryDate*:*2030-01-O,*IegMlRcfpresentative*:*jxx*.supervisoryAgency:XXX街道市场监首所二*scope*:h-跖生产、ifiVP-,addressw:,黄浦区XXX路XXX号*contactPersn*:张xxConuctPhone*:m1390000000*1ea1PersonType*:0*establiShnentDate*:*2020-01-0I”,*lxj5inessliccnsePicturc*:*datn:npplictioajpcgj
10、bosc6,lldk8234kIjksjdfk123iosdf,*registereddiress*:黄浦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:11pp1i
11、cntion/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:1”*ClQPicture*:*data:application/jpeg:base64
12、.dk8234kIjOksjdfkl23iosdf=*.*quarantIneInstitution:“检疫机构A*cert0fQuarantinex:YZSOOOOOI*.*cdf=*t*cxccutivcSundard*:*GB/1XX)1.XXX*J*circulation*:(quantity*:1000unit:吨*saleDate*r2022-02-0CUStoficrNnne*:“江苏得阳京市XXXX有41公司;*cstoncrAddr*:江苏省陶京市XXX路XXX号.，*custODCrTCl3WI000W0二uniSCID”(9131(XXKlOooOD(XXWX:*1icN
13、o*:*JV(XXKI000IM00(KI0*.*inspection*:(*ae64,dk8231klJOksjdfld23ios&df=*CeriEffectiMDaIJ:-2020-01-O*certExpirylktc*:*2030-0l-0,* 1ega1Representative*:张五x.supccisoryAgcncy:XXX街道巾场监管所，sc3:“优品生产、播鸨”* aiirtss*:黄浦区KXX路XXX号* ContactPcrson*:张XX”* c.rogiStercdAddrcss:黄浦区XXX路XXX号”，* regiJnrSHEnAUlhmiIyT“黄浦区市场
14、监怦管理局二businessxlelJflt!”“ceriificateSiaius”:1product*:*PrCdMtIonName饮料A*.producer。碇：生产厂商A”,*standard50011“shelf1.if:180ecategory*:-6*.*larcode*:6901231567892*certNo*r12345678*.*ccrtPicture*:*data:applicationjpegjbase64,dk8234kIjOks.jdfkl23iosdf=*pluciion*:*prodctiOnIbte:*2022-01H)1*baichXiMkr:202201
15、01”A.2返回潮代码示例（续）1DTorigin:上海市，certificationPicture*:*dit:nppIiention/jpeg:bosc64,dk823妹IjOksjdfkI23iosdf,，P，,zooooor.*,certfriginPiciure*:data:HPPlicatioJpeg:base64vdk82Mk1JOksjdfk12Siosdf=*”CIQNo*CKXX00)01*ClQf,dure*:*iata:applicalion/jfxgbMe64tdk82S1kIjksjifk123iosdf=*,*Quarantinelnstitution:f技机构A
16、”*certNoOfQuarantine-:JYZSOOOOO.*c?rtN)OfQuarantinuPicture*:*faia:a1ical沁n/jp皑；ba*c6l,lk821kIJOksjdfIc123idf=*,executiveStandard,:*GBTXXXXKX*J.circulation”:(*quantity*:1000,wunit-Hi*saldate*r2022-02-0rCustonerName*:江苏省苏州市有限公司”,cum“im”AddU江苏省苏州市XXX路XXX号cusUxnerTel*:*i8(XW00000*.*uniSCID*:-91310000000
17、0000*hcNo*：*jvoo(xxxooooo*,*inspection*:ZmerPriSCNamZ”被抽样值位名称V.*uniSCID-9i31(XXX000000002X“水1加。55；抽样地由province:上海市*-Cil厂上褥市二“county：“黄浦IXJ*sanipk?Naiw*:*ttl4AMlogory:食品大类*subcategorirs:作品亚类，*sanplcSt11d11rd*:“样品规格”,*batcWVmbcr”;样品批号，*prtciuciionlae*:*2022-01-01*.*checkTi三:2022-02-01”.*refrU)ate*/202
18、2-02-05*“producerm、”标识生产企业名称“，“prodUCerAddrcss”J标IR生产企业地址”,reportXunber*SNOOOOOOOOOX*.*chrckltrm-“insportElu。.：实际检测位1.“inspcctionKrxuItSm*i11spectixAsj11cy:上海检测机WSA.2返回消息代当示例()A.6接口应码说明接口响应码见衣A.4.*A.4接口应码及状态说明响应吗状态说明200服务器已成功处理请求40】未荻得登录授权或今牌失效403服务器拒绝谙求MM服务JB找不到请求的接口成页面500服务!S遇到错误，无法完成讲求502服务戏作为网关或代理.从上游服务拓收到无效响应503服务器Hflt无法使用(由于招我或件机雉护)5(MJH务器作为网关或代理.但是没有及时从卜.的服务磔收到请求
