DB3710 T 202-2023 停车场数据联网统一接入规范.pdf
《DB3710 T 202-2023 停车场数据联网统一接入规范.pdf》由会员分享,可在线阅读,更多相关《DB3710 T 202-2023 停车场数据联网统一接入规范.pdf(23页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 35.240CCS L 67DB3710威海市地方标准DB 3710/T 2022023停车场数据联网统一接入规范2023-09-20 发布2023-12-20 实施威海市市场监督管理局发 布DB3710/T 2022023I目 次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15数据质量要求.25.1基本要求.25.2数据及时性.25.3数据完整性.25.4数据可用性.25.5联网在线率.26信息安全要求.27接入方式.27.1HTTPS.27.2MQ(下行数据).37.3参数加密/签字.58接口说明.68.1停车数据接入接口.68.2系统保障接口.138.3基础
2、数据接入接口.16DB3710/T 2022023II前 言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由威海市公安局提出、归口并组织实施和评估。本文件起草单位:威海市公安局交通警察支队、青岛海信网络科技股份有限公司、威海城市投资集团有限公司。本文件主要起草人:于学龙、党荣国、王峰、马飞、邓高峰。DB3710/T 20220231停车场数据联网统一接入规范1范围本文件规定了公共停车场(库)管理系统数据联网数据质量要求、信息安全要求、接入方式、接口说明。本文件适用于
3、公共停车场(库)管理系统与威海市停车综合服务平台之间的数据联网,其它停车场(库)管理系统可参照使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 22239信息安全技术 网络安全等级保护基本要求3术语和定义下列术语和定义适用于本文件。3.1停车场(库)管理系统parking lot(garage)management system部署在各停车场本地,具有停车场(库)停车信息的采集、存储、传输、发布、管理、控制设备和应用等功能,并能向
4、威海市停车综合服务平台上传数据或与所属停车运营管理平台进行数据交互的系统,以下简称为“停车场(库)系统”。3.2威海市停车综合服务平台parking information service cloud platform由威海市政府主管部门指导建设,部署在互联网,用于汇集各停车场(库)数据并向社会提供实时停车指引服务的平台,可与政府其他系统对接等。3.3公共停车场(库)public parking lot根据规划建造的以及公共建筑配套建造的经营性机动车停放场所。来源:GB/T 29745-2013,3.14缩略语DB3710/T 20220232下列缩略语适用于本文件。HTTPS:超文本传输安全
5、协议(Hypertext Transfer Protocol Secure)ID:身份标识号(Identity Document)JSON:轻量级的数据交换格式(JavaScript Object Notation)JPG:面向连续色调静止图像的一种压缩标准,即JPEG(Joint Photographic Experts Group)MQ:消息队列(Message Queue)RSA:RSA加密算法(Rivest-Shamir-Adleman)5数据质量要求5.1基本要求外场设备与后台服务器之间应具备差错重传机制,因网络原因导致信息无法及时传输时,应在网络恢复后进行数据重传,保证数据信息可靠
6、不丢失。5.2数据及时性停车场(库)系统本地数据发生变化后,上传至威海市停车综合服务平台的时间应不大于5s。停车场(库)系统接收威海市停车综合服务平台下发数据的响应时间应不大于5s。5.3数据完整性入场记录和离场记录应完整上传并每日核对。入场记录和离场记录误差应不大于1%。5.4数据可用性5.4.1同一车场、同一车辆入场流水号唯一,且不可重复上传。5.4.2同一车场、同一车辆入场流水号与离场流水号应保持一致,保障进出记录完全匹配。5.4.3车牌识别准确率应不低于 99%。5.5联网在线率停车场(库)系统联网调试结束上传正式数据后,联网在线率应不低于99%。6信息安全要求应符合GB/T 2223
7、9等级保护第二级要求。7接入方式7.1HTTPS7.1.1调用方式以标准HTTPS协议POST格式组织数据形成传输参数,请求头Content-Type为application/json,返回值为JSON格式,所有参数和返回值均为UTF-8编码。7.1.2加密方式DB3710/T 20220233为保证系统接入的身份和数据安全,HTTPS协议POST参数内容为RSA加密后的密文和签名,系统不接收明文参数,详见7.2.2。7.1.3数据交互数据交互模式见图1。图 1数据交互模式7.1.4返回码说明返回码说明见表1。表 1返回码说明返回码说明200操作成功202参数错误500服务器错误7.2MQ(下
8、行数据)7.2.1订阅方式7.2.1.1停车场(库)系统通过订阅唯一主体(Topic),实现与威海市停车综合服务平台的业务通信。7.2.1.2MQ 主题格式如下:DB3710/T 20220234a)/qdpark/v1/calfee/accessID/parkingCode;b)/qdpark/v1/nosenseinfo/accessID/parkingCode;c)/qdpark/v1/noticepay/accessID/parkingCode。注 1:accessID为威海市停车综合服务平台分配的接入编号。注 2:如停车场(库)系统采用多节点部署,则每个节点的accessID为acc
9、essID_节点编号,如accessID_1、accessID_2,节点编号应为数字。7.2.1.3如采用平台级对接,可订阅父级主题,如/qdpark/v1/calfee/accessID/#,第三方车场平台能够收到所属旗下车场消息的,根据 parkingCode,第三方车场平台自行判断如何处理及回调威海市停车综合服务平台。7.2.2下发数据下发数据处理流程如下:a)停车场(库)系统收到消息后,拆分出密文 cipher 和消息签名值 sign;b)使用平台公钥对拆分出的消息签名值 sign 进行验签,如验签通过则签名验证成功,反之则验证失败;c)签名验证通过后,使用用户私钥对密文 cipher
10、 进行解密,解析原始数据。7.2.3数据交互停车场(库)系统采用MQ方式订阅威海市停车综合服务平台下发的业务数据,根据业务名称进行相应的业务数据处理,实现数据交互,见图2。图 2MQ 数据交互7.2.4参数说明DB3710/T 20220235下行数据使用一个消息队列,即Topic为qdpark/v1/对应接口名称/access ID/parkingCode,参数说明见表2。表 2参数说明参数参数名称类型参数说明是否为空requestID请求编号Long请求消息的唯一编号不可空timestamp时间戳String格式:yyyy-MM-dd HH:mm:ss不可空cipher用平台公钥对请求参数
11、加密String使用平台公钥对业务参数加密不可空sign用用户私钥对 cipher 加密String使用用户私钥对 cipher 签名不可空注:为确保通知信息与威海市停车综合服务平台的一致性,停车场(库)系统应利用接口里的状态时间戳字段进行最终通知信息确认。如通知消息时间戳比之前处理的时间戳小,则停车场(库)系统不做业务处理,直接回调接收成功信息。7.2.5MQ 业务参数下发封装规则示例 1:下发数据。requestID:1,sign:*,cipher:*,timestamp:2023-07-08 09:10:11示例 2:sign 为加密后业务参数的签名,cipher 为加密后业务参数,解密
12、后为 JSONparkingCode:WeiHaicity001,parkingName:WeiHaicity001,plateNo:鲁K01001,plateColor:0,.7.3参数加密/签字7.3.1秘钥秘钥分为用户秘钥(包括用户公钥和用户私钥)和平台秘钥(包括平台公钥和平台私钥),用户使用平台公钥对原始数据参数进行加密生成密文cipher,然后用用户私钥对cipher进行签名生成sign。7.3.2加密/签名过程7.3.2.1停车场(库)系统先将所有参数生成 json 字符串,然后将 json 字符串用平台公钥进行 RSA加密生成 cipher,再用用户私钥对 cipher 进行签名
13、生成 sign。威海市停车综合服务平台收到数据后,先用用户公钥对 sign 进行验签,验签通过后再用平台私钥进行解密(128 超长解密),从而提取原始数据,详见图 3。DB3710/T 20220236图 3加密/签名过程7.3.2.2签名算法:SHA1WithRSA;加密方式:117 超长加密。8接口说明8.1停车数据接入接口8.1.1上传车辆入场记录8.1.1.1车辆入场接口见表 3,请求参数见表 4,返回参数见表 5。表 3车辆入场接口接口要素内容描述接口说明停车场(库)系统将车辆入场记录上传到威海市停车综合服务平台调用周期实时调用条件修正车辆入场记录时,需实时上传接口类型POST接口地
14、址https:/localhost:8080/api/v1/cp/uploadModifyCarInDataDB3710/T 20220237表 4请求参数参数参数名称类型长度非空参数说明ID停车记录 IDString60是停车场(库)系统给出的车辆停车记录 ID(出场也需要传这个 ID)plateNo车牌号String50是车牌号,必须为正确的车牌格式,不带空格或-等特殊符号,对于无车牌车统一传“无车牌”三个字,未识别车牌的统一传“未识别”parkingCode停车场编号String45是该编号在停车场(库)系统中保证唯一gateNo岗亭编号String20否岗亭编号entryNum入口编号
15、String50是停车场(库)入口的编号operatorCode收费员编号String50否收费员编号freeBerthNum剩余开放泊位数Int6是剩余开放泊位数,当期时段可开放给公众停车的泊位数量,不含包月泊位、预定泊位等其特殊泊位arriveTime入场时间String19是入场时间(格式:yyyy-MM-dd HH:mm:ss)parkingType停车类型Int1是停车类型(1:临时停车;2:包月停车;3:共享停车;4:特殊停车)plateColor车牌颜色Int1是车牌颜色(1:蓝色;2:黄色;3:白色;4:黑色;5:绿色,6:黄绿)uploadTime上传时间String19是上
16、传时间(格式:yyyy-MM-dd HH:mm:ss)表 5返回参数参数参数名称类型长度非空参数说明resultCode操作返回码String3是参见 7.1.4msg操作返回信息String200是参见 7.1.48.1.1.2下面给出了接口示例。示例 1:传入值:JSONdata:gateNo:,plateNo:鲁K01001,plateColor:1,parkingCode:1001,operatorCode:01C001,freeBerthNum:70,arriveTime:2023-07-08 09:10:11,parkingType:1,entryNum:01,ID:1,uploa
17、dTime:2023-07-08 09:10:15DB3710/T 20220238示例 2:返回值:JSON:resultCode:200,msg:操作成功8.1.2上传订单修改信息8.1.2.1上传订单修改信息接口见表 6,请求参数见表 7,返回参数见表 8。表 6上传订单修改信息接口接口要素内容描述接口说明停车场(库)系统上传车辆入场记录修改信息到威海市停车综合服务平台,如纠正车牌号码等,需使用此接口重新上传。调用周期实时调用条件修正车辆入场记录时,需实时上传接口类型POST接口地址https:/localhost:8080/api/v1/cp/uploadModifyCarInData
18、表 7请求参数参数参数名称类型长度非空参数说明ID停车记录 IDString60是停车场(库)系统给出的车辆停车记录IDplateNo车牌号String50是车牌号,必须为正确的车牌格式,不带空格或-等特殊符号,对于无车牌车统一传“无车牌”三个字,未识别车牌的统一传“未识别”operateType操作类型Int1是0:修改订单信息,1:删除订单信息parkingCode停车场编号String45是该编号在停车场(库)系统中保证唯一gateNo岗亭编号String20否岗亭编号entryNum入口编号String50是停车场(库)入口的编号operatorCode收费员编号String50否收费
19、员编号freeBerthNum剩余开放泊位数Int6是剩余开放泊位数,当期时段可开放给公众停车的泊位数量,不含包月泊位、预定泊位等其特殊泊位arriveTime入场时间String19是入场时间(格式:yyyy-MM-dd HH:mm:ss)parkingType停车类型Int1是停车类型(1:临时停车;2:包月停车;3:共享停车;4:特殊停车)plateColor车牌颜色Int1是车牌颜色(1:蓝色;2:黄色;3:白色;4:黑色;5:绿色,6:黄绿)uploadTime上传时间String19是上传时间(格式:yyyy-MM-dd HH:mm:ss)DB3710/T 20220239表 8返
20、回参数参数参数名称类型长度非空参数说明resultCode操作返回码String3是参见7.1.4msg操作返回信息String200是参见7.1.48.1.2.2下面给出了接口示例。示例1:传入值:JSONdata:operateType:0,gateNo:,plateNo:鲁K01001,plateColor:1,parkingCode:1001,operatorCode:01C001,freeBerthNum:70,arriveTime:2023-07-08 09:10:11,parkingType:1,entryNum:01,ID:1,uploadTime:2023-07-08 09:
21、10:15示例2:返回值:JSONresultCode:200,msg:操作成功8.1.3上传车辆离场记录8.1.3.1上传车辆离场记录接口见表 9,请求参数见表 10,返回参数见表 11。表 9上传车辆离场记录接口接口要素内容描述接口说明停车场(库)系统上传车辆离场记录到威海市停车综合服务平台调用周期实时调用条件车辆离场时,需实时上传接口类型POST接口地址https:/localhost:8080/api/v1/cp/uploadCarOutDataDB3710/T 202202310表 10请求参数参数参数名称类型长度非空参数说明ID停车记录IDString60是停车场(库)系统的车辆停
22、车记录ID(跟入场是一个ID)plateNo车牌号String50是车牌号,必须为正确的车牌格式,不带空格或-等特殊符号,对于无车牌车统一传“无车牌”三个字,未识别车牌的统一传“未识别”parkingCode停车场编号String45是该编号在停车场(库)系统中保证唯一gateNo岗亭编号String20否岗亭编号operatorCode收费员编号String50否收费员编号freeBerthNum剩余开放泊位数Int6是剩余开放泊位数,当期时段可开放给公众停车的泊位数量,不含包月泊位、预定泊位等其特殊泊位parkingType停车类型Int1是停车类型(1:临时停车;2:包月停车;3:共享停
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB3710 202-2023 停车场数据联网统一接入规范 202 2023 停车场 数据 联网 统一 接入 规范
