DB3710/T 202-2023 停车场数据联网统一接入规范

ICS35.240

CCSL67

DB3710

威海市地方标准

DB3710/T202—2023

停车场数据联网统一接入规范

2023-09-20发布2023-12-20实施

威海市市场监督管理局发布

DB3710/T202—2023

目  次

前言II

........................................................................................................................................................

1范围1

...................................................................................................................................................

2规范性引用文件1

................................................................................................................................

3术语和定义1

........................................................................................................................................

4缩略语1

...............................................................................................................................................

5数据质量要求2

....................................................................................................................................

5.1基本要求2

.....................................................................................................................................

5.2数据及时性2

.................................................................................................................................

5.3数据完整性2

.................................................................................................................................

5.4数据可用性2

.................................................................................................................................

5.5联网在线率2

.................................................................................................................................

6信息安全要求2

....................................................................................................................................

7接入方式2

............................................................................................................................................

7.1HTTPS2

.........................................................................................................................................

7.2MQ（下行数据）3

........................................................................................................................

7.3参数加密/签字5

.............................................................................................................................

8接口说明6

............................................................................................................................................

8.1停车数据接入接口6

......................................................................................................................

8.2系统保障接口13

............................................................................................................................

8.3基础数据接入接口16

.....................................................................................................................

I

DB3710/T202—2023

前  言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由威海市公安局提出、归口并组织实施和评估。

本文件起草单位：威海市公安局交通警察支队、青岛海信网络科技股份有限公司、威海城市投资集

团有限公司。

本文件主要起草人：于学龙、党荣国、王峰、马飞、邓高峰。

II

DB3710/T202—2023

停车场数据联网统一接入规范

1范围

本文件规定了公共停车场（库）管理系统数据联网数据质量要求、信息安全要求、接入方式、接口

说明。

本文件适用于公共停车场（库）管理系统与威海市停车综合服务平台之间的数据联网，其它停车场

（库）管理系统可参照使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T22239信息安全技术网络安全等级保护基本要求

3术语和定义

下列术语和定义适用于本文件。

3.1

停车场（库）管理系统parkinglot（garage）managementsystem

部署在各停车场本地，具有停车场（库）停车信息的采集、存储、传输、发布、管理、控制设备和

应用等功能，并能向威海市停车综合服务平台上传数据或与所属停车运营管理平台进行数据交互的系

统，以下简称为“停车场（库）系统”。

3.2

威海市停车综合服务平台parkinginformationservicecloudplatform

由威海市政府主管部门指导建设，部署在互联网，用于汇集各停车场（库）数据并向社会提供实时

停车指引服务的平台，可与政府其他系统对接等。

3.3

公共停车场（库）publicparkinglot

根据规划建造的以及公共建筑配套建造的经营性机动车停放场所。

[来源：GB/T29745-2013，3.1]

4缩略语

1

DB3710/T202—2023

下列缩略语适用于本文件。

HTTPS：超文本传输安全协议（HypertextTransferProtocolSecure）

ID：身份标识号（IdentityDocument）

JSON：轻量级的数据交换格式（JavaScriptObjectNotation）

JPG：面向连续色调静止图像的一种压缩标准，即JPEG（JointPhotographicExpertsGroup）

MQ：消息队列（MessageQueue）

RSA：RSA加密算法（Rivest-Shamir-Adleman）

5数据质量要求

5.1基本要求

外场设备与后台服务器之间应具备差错重传机制，因网络原因导致信息无法及时传输时，应在网络

恢复后进行数据重传，保证数据信息可靠不丢失。

5.2数据及时性

停车场（库）系统本地数据发生变化后，上传至威海市停车综合服务平台的时间应不大于5s。停车

场（库）系统接收威海市停车综合服务平台下发数据的响应时间应不大于5s。

5.3数据完整性

入场记录和离场记录应完整上传并每日核对。入场记录和离场记录误差应不大于1%。

5.4数据可用性

5.4.1同一车场、同一车辆入场流水号唯一，且不可重复上传。

5.4.2同一车场、同一车辆入场流水号与离场流水号应保持一致，保障进出记录完全匹配。

5.4.3车牌识别准确率应不低于99%。

5.5联网在线率

停车场（库）系统联网调试结束上传正式数据后，联网在线率应不低于99%。

6信息安全要求

应符合GB/T22239等级保护第二级要求。

7接入方式

7.1HTTPS

7.1.1调用方式

以标准HTTPS协议POST格式组织数据形成传输参数，请求头Content-Type为application/json，返回值

为JSON格式，所有参数和返回值均为UTF-8编码。

7.1.2加密方式

2

DB3710/T202—2023

为保证系统接入的身份和数据安全，HTTPS协议POST参数内容为RSA加密后的密文和签名，系统不

接收明文参数，详见7.2.2。

7.1.3数据交互

数据交互模式见图1。

图1数据交互模式

7.1.4返回码说明

返回码说明见表1。

表1返回码说明

返回码说明

200操作成功

202参数错误

500服务器错误

7.2MQ（下行数据）

7.2.1订阅方式

停车场（库）系统通过订阅唯一主体（Topic），实现与威海市停车综合服务平台的业务通信。

MQ主题格式如下：

3

DB3710/T202—2023

a)/qdpark/v1/calfee/{accessID}/{parkingCode}；

b)/qdpark/v1/nosenseinfo/{accessID}/{parkingCode}；

c)/qdpark/v1/noticepay/{accessID}/{parkingCode}。

注1：{accessID}为威海市停车综合服务平台分配的接入编号。

注2：如停车场（库）系统采用多节点部署，则每个节点的{accessID}为{accessID_节点编号}，如{accessID_1}、

{accessID_2}…，节点编号应为数字。

如采用平台级对接，可订阅父级主题，如/qdpark/v1/calfee/{accessID}/#，第三方车场平台能够

收到所属旗下车场消息的，根据parkingCode，第三方车场平台自行判断如何处理及回调威海市停车综

合服务平台。

7.2.2下发数据

下发数据处理流程如下：

a)停车场（库）系统收到消息后，拆分出密文cipher和消息签名值sign；

b)使用平台公钥对拆分出的消息签名值sign进行验签，如验签通过则签名验证成功，反之则验

证失败；

c)签名验证通过后，使用用户私钥对密文cipher进行解密，解析原始数据。

7.2.3数据交互

停车场（库）系统采用MQ方式订阅威海市停车综合服务平台下发的业务数据，根据业务名称进行

相应的业务数据处理，实现数据交互，见图2。

图2MQ数据交互

7.2.4参数说明

4

DB3710/T202—2023

下行数据使用一个消息队列，即Topic为qdpark/v1/对应接口名称/accessID/parkingCode，参数说明见

表2。

表2参数说明

参数参数名称类型参数说明是否为空

requestID请求编号Long请求消息的唯一编号不可空

timestamp时间戳String格式：yyyy-MM-ddHH:mm:ss不可空

cipher用平台公钥对请求参数加密String使用平台公钥对业务参数加密不可空

sign用用户私钥对cipher加密String使用用户私钥对cipher签名不可空

注：为确保通知信息与威海市停车综合服务平台的一致性，停车场（库）系统应利用接口里的状态时间戳字段进行

最终通知信息确认。如通知消息时间戳比之前处理的时间戳小，则停车场（库）系统不做业务处理，直接回调

接收成功信息。

7.2.5MQ业务参数下发封装规则

示例1：下发数据。

{

"requestID":1,

"sign":"*****************",

"cipher":"*****************",

"timestamp":"2023-07-0809:10:11"

}

示例2：sign为加密后业务参数的签名，cipher为加密后业务参数，解密后为JSON

{

"parkingCode":"WeiHaicity001",

"parkingName":"WeiHaicity001",

"plateNo":"鲁K01001",

"plateColor":0,

...

}

7.3参数加密/签字

7.3.1秘钥

秘钥分为用户秘钥（包括用户公钥和用户私钥）和平台秘钥（包括平台公钥和平台私钥），用户使

用平台公钥对原始数据参数进行加密生成密文cipher，然后用用户私钥对cipher进行签名生成sign。

7.3.2加密/签名过程

停车场（库）系统先将所有参数生成json字符串，然后将json字符串用平台公钥进行RSA

加密生成cipher，再用用户私钥对cipher进行签名生成sign。威海市停车综合服务平台收到数据后，先

用用户公钥对sign进行验签，验签通过后再用平台私钥进行解密（128超长解密），从而提取原始数据，

详见图3。

5

DB3710/T202—2023

图3加密/签名过程

签名算法：SHA1WithRSA；加密方式：117超长加密。

8接口说明

8.1停车数据接入接口

8.1.1上传车辆入场记录

车辆入场接口见表3，请求参数见表4，返回参数见表5。

表3车辆入场接口

接口要素内容描述

接口说明停车场（库）系统将车辆入场记录上传到威海市停车综合服务平台

调用周期实时

调用条件修正车辆入场记录时，需实时上传

接口类型POST

接口地址https://localhost:8080/api/v1/cp/uploadModifyCarInData

6

DB3710/T202—2023

表4请求参数

参数参数名称类型长度非空参数说明

停车场（库）系统给出的车辆停车记录ID（出场也

ID停车记录IDString60是

需要传这个ID）

车牌号，必须为正确的车牌格式，不带空格或-等特

plateNo车牌号String50是殊符号，对于无车牌车统一传“无车牌”三个字，

未识别车牌的统一传“未识别”

parkingCode停车场编号String45是该编号在停车场（库）系统中保证唯一

gateNo岗亭编号String20否岗亭编号

entryNum入口编号String50是