DB31_T 1492-2024 智能物联 城市智联平台数据接口技术要求.docx

ICS35.240CCS1.79DB31上海市地方标准DB31/T14922024智能物联城市智联平台数据接口技术要求Inte1.1.igentIoTTechnica1.requirementsofdatainterfaceforurbandigita1.SerViCep1.atform2024-0775霍布2BHHa蚣上海市市场监督管理局发布智能物联城市智联平台数据接口技术要求1CT本文件规定了城市智联平台对外提供的智联平台接口基本要求、传输要求、应用类接11要求、对接云边掂协同通用接口要求、应用场景云边端物同接口要求。木文件适用于接入城市智顺平台的应用场景的数据接口设计与开发，2黑效性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款，其中，注日期的引用文件，仅该日期对应的版本适用于本文件：不注1.1.期的引用文件,其最新版本（包括所有的修改单）适用于本文件。GB,T2260中华人民共和国行政区划代码GB7588电梯制造与安装安全规范GB21240-2007液压电梯制造与安谀安全观他3术甯和定义GB7588和GB21240-2007界定的以及卜列术语和定义适用于本文件。3.1城市智联平台Urbaninte1.1.igentIoTdigita1.servicep1.atform智联平台以提升城市运行安全及运行效率为目的，基于物或网的传输途径，接收普健终端设备、智能网关的信息，进行数据治理、挖掘等处理，为政府、企业、个人提供应用场毙服务所林立的数字服务平台。321飒关inte1.1.igentgateway对智能终端设备进行控制、管理,笊聚、存储、传给交换智能终端设备的数据.进行面向场景的数据分析、处理和应用处于智联平台与智能终端设备之间的一种网关设备.33智能典Ift备InU1.1.igentenddevice通过标准协议与智能M关及智联平台通信的前端数据采集、识别、存储的设的.3.4Wevent智联平台运行中引发业务状态或软现件设备健康状态变化的过程.33云边IMnc1.oud-edge-endCo1.1.aborat100ZM智联平台）、边（智能网关八端（智能终端）三者之间通过接口交互实现数据I可步、设备管理、业务应用的过程。业务影子businessShadoV用来保证云边域业务相关信息的及时性和最终一致性的一种面向业务应用的设备持久化配J84下列缩略语适用于本文件CAES:高级加南标准(AdVanCedEncryptionStandard)AK.'SK:访问标识/访问密:胡(ACCCSjiKeyIdzSccrctAccessKey)CA:证书颁发机构(Cer1.ifka1.iQnAIHhQri1.y)1.b¼C:哈希消息认证码(IktSh-basedMessageAu1.hen1.ica1.ionCode)HTTP:超文本传输例议OIyPGr1.eXITransferProtoco1.)HTTPS:超文本传输安全防议(HyP5TextTransferPriHowIoverStxurcSixrket1.ayer)1AM:身份识别与访问管理(IdCmiIyandAccessManagement)IP:网际互联协议(Imen1.eIPooco1.)JSONJavaScrip1.时象标记(JaVaSCriP1.ObjectNotation)MD5:消息摘要律法(MCSSagC-DigCStA1.gorithm)MQTTi消息队列遥测传输(MCSSageQueuingTe1.e三etryTransport)RESTfuI:入征状态转移IRCPrCSCntaIk)na1.StateTransfer)SH:安全敌列算法(SeCUNHashA1.goriihm)SN:序列号(Seria1.Number)TCP:传输控制协议(TranSmiSS沁nCon(11>1.Pro1.oco1.)T1.S:传场，层安全协议(TranSPOrt1.ayerSecurity)URI：统一资源标识符(UnifbrmResourceIdentifiertURD5«¥台接口鼻粳求6.1接口分类6.1.1接口关系智族平台接口由云边端协同接口与应用接口组成，接口关系见图1.4字段命Z规数r由多个部分如成.每个部分由小写英文单词、常用缩珞语、数字构成，各部分使用下划战进行连接；5数擀字典色：明确取tf1.范围.C）字符集1符合IETFRFC3629中的规定.5.2.3接口安全性要求智联平台的云边端协同接口、应用接口在涉及接口协议、数据格式及安全性定义时均应符合以下要求：a）数据安全：D采集个人浓感数招：采用AES256或史高等级加密后传输：2）使用个人敬监数据；加密或脱放后使用，其中人像数据应加密成模糊化处理，b）传输安全：MQTT/HTTP类接口采用TIS加密；C）认证与窑权：接I1.具备认任与鉴权机制,选用AK，$K、CA证书等方式.6传要求6.1 阿带宽联网系统传输带宽应符合以下要求：a）联网系统网拈带宽设计满足智能终端设备接入智能网关、智能网关接入智联平台、智联平台为应用平台提供业务服务的带宽要求,并田有余出：b）智能终端设符接入智能网关的支持千兆以太网接口，业务带宽不少于100MB's;C）智能网关接入智联平台支持干亮以太网接口.业务帝竟不少于100MB/s：d）智联平台为应用平台提供业务服务以千兆以太网接口或乔万亮以太网接口接入网络.6.2 MMHtMrft*联网系统IPN络传输质量（如传输时延、包丢失率、包误差率等）应符合以卜要求：a）网络时延上限值为400ms;b）时延抖动上限值为50ms;C）丢包率上限的为IX1.O-6.3 网博可,1»求年服务可用性（年总分钟数扣除年服务不可用分钟数后，与一年总分钟数的比值）不低于99.96.4 业务接口平均时*应用场段的业务数据报送智联平台应符合如卜要求：a）消息类接I平均时Ji1.边、端设备到智联平台的消息传输平均时延不大于2s：bRESTu1.接口平均时延如下所示，D应用平台与智联平台间非批后操作接口平均时延不大于3s;2）应用平台与智联平台间批状操作接口平均时延不大于1。S.7Ifi用类接口及求DB31/T149220247.1 应用突遢用捶口戛求7.1.1 队证与峥7.1.1.1 认证与权SUB认证与鉴权流程见图2.H2认证与量权流*图认证与'警权流程包括：a）认i匹依据谛求字段生成签名，网关对签名采用相同的HAMC算法进行验证，如果一致则放行.否则返回401.认证失致：b）饕权：请求认证通过后，网关将请求转发到IAM模块进行权限鉴定，如果通过则转发到数字服务平台对应的接口服务,否则返回401,授权失散：c）授权：相关字段统通过请求头传递，主要包拈AK、甚名等字段.7.1.1.2 队证与峥算旅智联平台统提供AK,5K.用于按I请求的认证和赛权.请求头中应包括"Me”fH-aut1.）orizatio字段,请求签名由HAMCw法生成.请求签名的字段应包括当前时间、请求方法、请求URI、HTrP协议及根本.7.1.2 接口列我通用接口列表应符合表1的规定。«4用接口列量分类接口阴碍用途通用接口!,Im-C(I0I设置攻据回调接口.用接收准实时数据.如小件告警、设备状杳更新等PP<CM02取游数由回调接【1,川取滂敢据回调接口的设置7.1.3交互拉道«29(«)潸电体字段名称牧据类型可仝制峋应IogRSMOp1.ogN操作H志数据，从谙求的掇作Fi志序则号比的号开始，按*id由低到高排序.；11:返网的操作H志数心可使小于请求教.因为返回数4K需要小于1股可以多次请未获取完整的操作日志.注2:实际传蛤时涧息中的探作H志数1«以0JTW>gs消息体序列化后优于mssagefn«cCtintent1I'*header中泊总体并不包含1.ofistt½codestringN谓求返网码，默认ScQK,字典应符合附.次A.4Ranp1.ngheaderHG1.tdCrobjN操作日忐结构体datastring(byte>N业务数据.自定义8.3.4 m11蝴口8.3.4.1 g下发接口数据下发接11应符合我30的规定.«30B下发接口表IOr-DSOO1.名称数据下发协仪MQTT序列化格式proiobuf说明云下发数据到边端设备或边下发数据引端设备消息体字段名称数榭类型可空描述请求registryidstringN美联i殳备从展的租户标识deviceidstringN设招标巩，范国:SI1.256(C<W,1WMME1-PR(IHjCIttiV1.CESN)PrOVi<icrstringYRpC提供方ca1.1.erstringNRRCiH用方,预留字段，豺时放空11itmestringNRPC调用名称kindstringNRK酒用类型.-rcBID1.R1.rn族:双向请求，RPCj)NEWAY:的句请金,不。要返同deadIinestringNRpCfiI时时长.0代表使用默认K时时间contentstring(byte)V请求消息体，业务数榭，建议JNK格式，逋过消息类型区分不同的业务数据8.3.5 文件同步接口8.3.5.1 小文件上传接口小文件上传接口应符合表32的烧定.«32小文件上传接口表编号IOT-FMOOi名称小文件上传仍议WQTr序列化格支PrCtQbIIf说明小攵件上传接口.用干边、墙设符上化小于1川的文件到云或靠设饴上传小于1WWft文件到边消息休字段名称数粼类也可空描述请求bucketnancstringN空向名称b1.obstring(b)tc)N对象数据,粒Hh任就二进制数据metadataMeUIdzHN对象无数幅，对象元信息，内容为S3和CISG支并的对象元信息objectnanostringY对象名称,支持指定对望名称，在支持S：麻涯接口的存储(如IIinio)可使用,注意：相同的ObjeCtn皿?将用盅Ki文件I不支持指定名称的存砧(如OSG.该字段必须为空，否则返网错误Metadatasizein1.ier(int22N对象数据大小，值位为Bytd上传时由系统i5i置为对接数据实际大小，BtfrtJuff1.i(0.1024«1024CtgstringY对象致IKI1.d5枚S(ft.in,aa-1.1efea1b3e«b%f303HS61ff8392.-IRW；«下建议提供此参数用J数据进行端对中的校酸Con1.en1.1.yPestringY圻定数据内容类?1!Creatrdatstring(da1.e-tine)Y对能创建时间.使MuTC时区.attrsstringYauww%可