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%可放入相关业务信息,范用：任.如I'CaiWnCi(T123'响应ObjgCt_keystringN对象标识数拼格式:bucketn»n?)/(object.naneI8.3.5.2 小文件下接口小文件下我接门放符合发33的规定.«33小文件下«口我城号1.(>T-FM0O2名徐小文件下我办议嵋门序列化格代Protobuf说明小文件下我接”用丁从云下我小门MB的文件到边、湍设备或边下我小于1出的文件到端设备in息体字段名称t据类型可仝描述请求bucket_nanestringN空向名称<jbject11anestringN文件对象名称响应b1.obSIring(byte>N对象数屈(u?tadataMetadataN元数据Metadata!61Z<!integer(int32)N对象数据大小.举位为byte.上传时由廉统设'捏为对象数据实除大小.取值范Hb<0,1024*1024CtAgstringY对象itsd5校收值，¼.aa1.1.ef0a1b<b9bfW3H56】ff8392.-股情况下建议极供此数用于数据进行坳对瑞的校$&conteni_typestringY指定牧据内容类不Crmtffdntstring(dote-ti11e)Y对象创建时间.使用Ure时区attrsstringYIf1.KVJMS,可放入相关业务信息，兔B1：任也tacaf1.raid-123,J8.3.5.3 大文件上传捶口大文件上传接门应符合表34的规定.«34大文件上传接口我编号IoT-FM003名林大文件上传协议丽序列化格式Protobuf说明大文件上传接口,获取学】NB的文It磔接.用于从边、端设备上作文件到云或瑞设备上传文件到边.获取到跳接成在设备瑞需要在Ifi定过期时间IK1.完成上佞操作图12应用场景数据交互图92应用场景通用数据定义9.2.1 率件信息数据实体：Evcin1.nfb.属性：设备标识、事件类型、事件内杵、抓拍图链接、事件时间戳等.9.2.2 通知发布信息数据实体：MessageInfo1M性：工程标识、发布伯息内容、发布时间微等.93应用场景业务效定义根IW具体应用场块进行定义，可参照附录C的应用场景示例.40用量A（A范性）A.1说明字典值用于约定堆边公交互过程中的指令码，不应的懑更动，如若新增字典应与对应的云边端时接方协商一致后更新此字典色.M2设备状毒设备状态字典应符合表RJ的规定.茹码名称DSJINAC1.nED未激活状态DS_ACTIVED已激活状态DSON1.INF在线状态DSOF1.INE态线状态跖一DISAB1.ED禁用状态A.3设备类S1.设品类型字典应符合去A.2的规定,«A.2«*««名务H1.!NKNWAN未知TTEDGEGATEWAY边缘冏关TTEDGEDBtICE动缘设JST1.END一StBDEY1.CE子设备A.4请求返回网请求返回码字典应符合表A.3的规定.*A3请求返Ia1.机应吗名称SCOK成功SCSCCANCE1.1.ED客户端取消调用SCIMaoIN未知楮送SC.D'A1.1D-RG1.EKT无效餐数SCDE4DUNE_EXQ旧JED调川郑时表儿3（馔）烟玛名称SC.NOT.FO1.WD资源未找到Sca1.readiexists贾源已存在SCPERMISSIONDEMED非法访问Se1.UXAn1.咏T1.GVreD未技权SJRESO皿EfxHAUSra)资源耗尽SCFA【1.EDPRECCM)IT1.(调用条件异常SC.ABORTED事务取消SCO1.r1.MRANGE咨数.用M也限SC1.MPI1MEME1>未实现SC.INTERNA1.啜务器内选错英SCUNAVIU1.iw1.E服务不可用SCDATA1.OSS数如损坏SCDEVICEIMREAaAB1.E设在无法访问SCDEVICETIMENOJSYNC设的时间未同步A.5日志级别日志级别字典应符合表A.4的规定。«A.4日志锻别我埼码名称IJoGDEBIw盟武纵别1.oGJNFO信息级别IJoGjAKNN1.NG警告极别Uogerror错误缓别1.OGJ三E关闭A.6业务件于R状态业务影子配置状态字典应符合表A.5的规定.狙5业务汗配状U褊码名林CwnG-I1.NINITIA1.1.ZE1.)未初始化QWIGAPP1.YING配置应用中CONEIGAPPu印也世已应用Cowigjnya1.idIV置无效A.7画类型回两类型字典椀符合表A.6的规定*.6洞玛名称EVBVT异常事件Di-VICESTATUSIPIXME设番状态更新.F国家统计局12位编码的荔础上扩展6位到18位,其中小区和楼栋各3位,具体规则应符合表B.1的短定。«B.1.行政Wsm层级说明a玛现则备注1W/Hff1.00WIWGB/T2260«i«2地线市(W3区/县«04乡SV街道000根据家统计总发布统计用X时代码和城乡划分代码规则,国统字(2009)91号)5社区(村)居委会WXJ6小区000以平台跳入总序纲科7梭株000以楼称号顺序注码川录C（Mtt）应用嫣量示例C.1示制场景殳务我定义示例场景业务数据描述了智优电梯、智能停车场（库）、智能社（园）区'智能道路公共设施等应用场景的部分重要业务数据.定义参见表C.I的规定«C.1示辍HHk务效定义列业务数据名称数据实体属性视频监控信总VideoInfo开始时间，结束时间、视频存储储接，采桀时间IK等电梯运行信息E1.evatorStatInfo电梯站码、所在楼层.运行方向、是否有人、开关箱入状仓.侨门状态、服务模式.运行状态、关门到位'机房关门到位、叨引机状态、开锁区域.电梯故障码、其他信息、采集时陶我等电幡环境信息E1.evatorEnvInfo电梯设备俄内、梯内沿段，梯外温度，环境外温度、风力骅级，风速.天气状态、PM2.5做、采集时间数等焕楼记录信息RideRecord1.nfo设番标识、常驻用户、是否有陌生人乘坐、人数、进电帏时的楼层、抓拍图梃接、当日人流9,记录时间IB抨停车场（麻）信息ParkInfo编号，名称、详细地址,总可预订车位数、场圾.经昔信息、平面图、收费标准等出入口信息EntranceInfo出入口11）、8称、（9乍场（库烟号、出入口类型等场内车位数信息ParkSpac«Info秒车场（年）漏号、已使用车位数啧.利余车他裁财，已预订车位数车辆管控名单信息BhckMhitcOrayShcct1D.停车场（峰）编号、车辆信息.控制镣略类型、开始时间、结束时间等车辆的人记录信息ParkRecordInfo记录）、停车场（库）第当、车位蝙号、车牌号、掠柏图枝接、入场时间、入场设备ID,出场时间、出场设i11>,采集时间裁石人员通行记录信息PassRecordInfo设备标识.抓拍图链接、背嵬大图链接'姓名、年龄、M拍图。倏咋图的相似度得分，性别、AIftMtt.底库图标识、抓拍时间我第道路工程施工设备监iW信息RoadProjectDeviceMonitorInfo设备标识、工程标识、司机姓名、司机身份证号、设备状态、其他信息、聚矍时间微等工程现场环境监利信息PiojectEnvInfo工程标识、扬尘PMo0、扬尘PMI0、扬尘FM2.5、阻度，嗓音、温度、风向、风速、其他信息、果柒时间联等«C1(tt)业务数据名称数据实体磁性车辆Hi停记录伯息Parkvio1.atioaxRccordInfo记录ID,Hi件取证类型、Hj惇抓指图跳接、车牌号,采集时间嵌等环境监测传息EnvInfo大气污染类型.大气汨染的、室内温度、室外温度、环境外涉度.风力等级，14速、大气状态、PM2.5tf（,水环境污染类制、水污柒值、环境*声位、耳他估息.梁集时间戳等消协水系统监测信息SafctyWatrrInfo水廉统设品类型，水位及管网水汽似，尤他信圾、来集时间破等电气火灾IX测值gIsiectrico1.Fire1.nfoItt蒲类型、状测目标、监测目标值、MftfSA.枭鬃时间戳等C.2能电称曙量接口智能电梯场景果造以智能电梯为中心的系列微服务,构成这些微限务的数据通常由个或多个部落在智能电悌场景中的终期设备采集、处理、报送.智能电梯场景都分云边端作同接11参见&C.2的规定.*C.2修电重用*云边4*1接口列班分类接口编码用途智罐校测类DG-E-DOO1.人员通行记录刈传接11,用于人员电检通行记录数据网传智的检测类DG-E-Do02A员乘悌也蒯数楙回传接口,用于常驻或陌生人的乘悌数榭回传DG-E-DO03抽烟事件检蒯接口用于抽烟事件数据回传DG-E-DaM电植乍进梯U件检测接.用于电瓶下进梯事件数据回传DG-E-Do0511斗事件构测接口.用于打斗事件数楙M传DG-E-Da)6胞跳出件检测接口,用于跑跳第件数据M传DG-E-DOOj老人/儿童独自束悌型件检测接口小干老人/儿Ift独自乘梯事件数抠K1.传DG-E-Da18防疫着装不符小件检消接口，用于防疫a装不符力件攻抵阿传DG-E-DC09遗留物品事件馀测接I1.用于遗留物储事件数据回传DG-E-DC1.O张贴事件枸测接a.用于张贴广告事件数楙回传DG-E-DC1.1涂料事件检利接口，用于涂鸦事件数据回传DG-E-Da2人员长时间滞用十件检测接11，用于人房长时间海用犷件数据网传电梯运行DC-E-ROT1.电梯运行文时数据高菽回传接11,用于电栉实时运行数第高领H1.传DG-E-RD02电梯运行实时数据中城网传接【1,川卜电梯运行实时效据中炖卜”传DG-E-RM3电梯统H数由低频回传接口,用于电梯统计数据怔姒回传其他DG-E-EDO1.环境数据H传接I,用于环境数据同传C.3ITf1.B停车矮（鼻）端量接口智能停车场（库）场景塑造在沼能伶车场（库）环境中的系列微腹务,构成这些微眼务的数据通常由一个或多个怖詈在智能停车场（库）场景中的终端设符来集、处理、报送.智健停不场（际）场景部分云边端协同接11参见&C.3的现定.«C.3!停车场（鼻）均量云边接口列4t分类接口看码用途智能依测类IXi-Ix-IW1.乍辆人口信电接口，用于修乍场（保进入车辆乍牌Ih抓扣图链按、入场时f><h入场设备Hh呆集时间裁数据回传H能检测类DG-P-PM2车辆入口佰患接口,用于停车场（原）段出车辆车牌号.抓拍图集接.出场时间'出场设备ID、呆处时间戳数据回传MJ-P-PDo3车位状态僧息接U,用于当前车位是否被占用的僧息数剧回传C.4催道咯公共“*场量接口H俄道路公共设施场景也造在M健道路环境中的公共设施所提供的系列依服务，构成这些做收务的数据通常由一个或多个部皆花有能道路公共设施场景中的终端设备来黑、处理、报送.哲能道邦公共设施场景部分云边辎办I司接口参见表C.4的规定.«C.4传道事公共”场量舞口列表分类接口痂码用途出设管投类DG-R-BCO1.收招监测数据回传按11,用干设备监测数据回传IX；-R-BCo2环境监测故第H传接口，用于环境监测数粼网传DG-R-Bco3机领监控敢於何传接I1.川找筑监界故粼回传DG-R-BOM值克发布事件回（勺援口.用于信息发布事件故据回传道路推佻类DG-R-RMO1.环卫设施然测数据同收推口，用于垃圾桶、坨坂诘等1据阿收DG-R-RM02道路结构健瞋监测数据IS1.传接口,川T桥梁、边坡、路礼、隧道等数则对传DG-R-限03应急事件回传接1.用于2多防滑除劣.冬季除冰凌.4孽防汛、如故推车等数提问传交通信©州分类DG-R-RIO1.拥堵带件回传接口.用于加堵路段、拥堵预警、预计通帽时间等数刎网传IJG-R-R102出租和数据回传热口，用于乘坐车辆信息、人员信妞、照片.上车时间.下车时间、消费金题等致据回传DG-R-RI03M的车数据网传接口,用于架坐车辆侑恩、人员信息、照片、上车时何、下车时间、泊份金颍等数MM传IXi-R-RIOI路边临时停车如回传接口,用于车牌8.车辆照片、停车时间、离开时间'消费金柩笠数据网传DG-RR1.OS公交车牧据伸接R.用于车辆位置、沿途路况、乍辆到站时间、班次信息等数据回传DG-R-R106智艇灯杆数据回传接口.用于信总发布.公共广播.环境监测.度乡呼叫等i据回传11)GB,T7408数据元和交换格式信息交换H期和时间表示法2GBT35273信息安全技术个人信息安全规他3J1ETFRFC2616超文本传怆协议HTrP!.KHypcncxtTransferProtocoI-HTTP.,1.1>41ETIzR1.C2818安全超文本传输协议(HEOverT1.S)5)IETFRFC3629if-WUnkcxIe的可变长度字符编码(UTF-8.“IranMOrTn“1.ionfo11na1.ofISOI0646)6IETFRFC8259JSoN数据交换格式(ThCJavaScriptObjectNotation(JSON)DataInterchangeFormat)