DB4403/T 315-2023 停车库（场）预约共享数据接口规范

ICS35.240.01

CCSL67

DB4403

深圳市地方标准

DB4403/T315—2023

停车库（场）预约共享数据接口规范

Specificationforreservationandshareddatainterfaceofparkinglots

2023-02-15发布2023-03-01实施

深圳市市场监督管理局发布

DB4403/T315—2023

目次

前言...............................................................................II

1范围.............................................................................1

2规范性引用文件...................................................................1

3术语和定义.......................................................................1

4缩略语...........................................................................2

5总体要求.........................................................................2

6功能要求.........................................................................3

7数据接口要求.....................................................................4

8数据传输要求....................................................................38

附录A（规范性）具备预约共享业务功能的停车库（场）建设要求........................40

附录B（资料性）停车业务场景及流程................................................41

附录C（规范性）编码定义..........................................................47

附录D（资料性）签名和接口使用示例................................................49

参考文献...........................................................................80

I

DB4403/T315—2023

前言

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

定起草。

本文件由深圳市公安局交通警察局提出并归口。

本文件起草单位：深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市顺易

通信息科技有限公司、鹏城智慧共享科技（深圳）有限公司、深圳市博思高科技有限公司、深圳市

凯达尔科技实业有限公司、深圳锦沃科技有限公司、深圳市道尔智控科技股份有限公司、深圳市豪

位科技有限公司、深圳智优停科技有限公司、深圳市安赛科技有限公司、深圳信路通智能技术有限

公司、深圳市奇见科技有限公司、深圳市富士智能股份有限公司、深圳市红门智慧停车科技有限公

司、深圳地铁物业管理发展有限公司、深圳市计通智能技术有限公司、深圳市皇驰科技有限公司、

深圳市中安测标准技术有限公司。

本文件主要起草人：陈显东、陈晓宁、王乐、徐伟剑、郑雷克、蔡志敏、张毅、高皓、何军、

李民、吴曲曲、黄应辉、梁峰、董晓波、李静涛、黄钟洪、王桃、何宝华、杨纪刚、黄兰发、方明

星、陈明春、李友斌、李志亮、徐纯梁、叶汉中、陈汉、曾北桂、蒋志文、朱志波、曲飞宇、童洪

明、白国强、陈在杰、陈鑫、吴金平。

II

DB4403/T315—2023

停车库（场）预约共享数据接口规范

1范围

本文件规定了停车库（场）预约共享停车业务的总体要求、功能要求、数据接口要求、数据传

输要求。

本文件适用于深圳市范围内停车库（场）管理系统或停车管理平台与预约共享停车平台之间的

数据交换以及功能设计与开发。

2规范性引用文件

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

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

适用于本文件。

GB/T2260中华人民共和国行政区划代码

GB5768.2道路交通标志和标线第2部分：道路交通标志

GB/T10114县级以下行政区划代码编制规则

GA/T761停车库（场）安全管理系统技术要求

DB4403/T89智慧停车基础信息编码技术规范

SZJG44停车库（场）车辆视频图像和号牌信息采集与传输系统技术要求

3术语和定义

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

3.1

车位提供方parkingspaceprovider

具有车位产权或使用权，并在一段时间内提供车位的组织或个人。

3.2

停车用户parkingspaceuser

接受停车服务的组织或个人。

3.3

预约停车reservedparking

车位提供方（3.1）向停车用户（3.2）提供约定时间内预约入场或预约到位的服务。

注：停车用户提前申请、预约才可享受停车服务。

3.4

共享停车sharedparking

车位提供方（3.1）在车位空闲时向停车用户（3.2）提供停车的服务。

3.5

服务商parkingattendant

为停车库（场）提供预约共享能力解决方案和经营管理服务，协助停车库（场）接入预约共享

停车平台的组织或个人。

1

DB4403/T315—2023

注：服务商包括但不限于停车库（场）运营（承包）公司、平台厂商、城市停车运营服务平台运营方、物业管

理企业、工程商/集成商、设备厂商等。

3.6

预约车辆parkingreservationvehicles

向具备预约停车（3.3）的停车库（场）预约某个时段停车的车辆。

3.7

停车库（场）管理系统parkinglotsmanagementsystem

对出入停车库（场）的车辆进行登记、出入认证，监控和管理，提供停车库（场）区内引导、

寻找车辆等一系列功能的电子系统或网络。

3.8

停车管理平台parkingmanagementplatform

用于对路内停车泊位或路外停车场进行统一运营、监控和运维管理的系统或平台。

3.9

预约共享停车平台reservationandsharedparkingplatform

运用物联网、云计算、大数据等技术，通过与第三方停车、充电、机械车库等系统或平台的对

接，获取、处理停车库（场）停车信息，将各停车资源互联互通实现停车资源共享、一账通行等，

对向社会大众提供目标区域范围内车位寻找、车位引导、预约停车（3.3）、共享停车（3.4）等服

务的系统。

3.10

流量管控flowcontrol

根据停车库（场）内剩余车位数，动态调整入场车辆的放行规则。

3.11

饱和度saturation

停车库（场）内停放车辆数与总车位数的比值。

注：总车位数指可用于预约和非预约车辆停放的车位总数。

4缩略语

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

APP：应用程序（Application）

HMACSHA256：使用安全哈希算法256的消息认证码（Hash-basedMessageAuthenticationCode-

SecureHashAlgorithm256）

HTTPS：安全套接字层的超文本传输协议（HyperTextTransferProtocoloverSecureSocket

Layer）

ID：标识编码（Identification）

MQTT：消息队列遥测传输（MessageQueuingTelemetryTransport）

NTP：网络时间协议（NetworkTimeProtocol）

QoS：服务质量（QualityofService）

5总体要求

5.1具备预约共享业务功能的停车库（场）建设应符合附录A的规定。

2

DB4403/T315—2023

5.2预约共享停车平台与各停车库（场）管理系统或停车管理平台进行数据对接，预约共享停车业

务示意图见图1，具体接入方式如下：

a)预约停车资源或共享停车资源通过停车管理平台接入预约共享停车平台进行数据交互；

b)预约停车资源或共享停车资源通过停车库（场）管理系统接入预约共享停车平台进行数据

交互。

预约停车

资源

停车管理平台

共享停车

资源

预约共享停车平台停车用户

预约停车

资源

停车库（场）管理系

统

共享停车

资源

车位提供方服务商平台运营方用户端

注：实线框表示在本文件界定的范围。

图1预约共享停车业务示意图

5.3当产生共享停车业务或预约停车业务时，停车业务场景及流程见附录B。

6功能要求

6.1通用要求

接入预约共享停车平台的停车库（场）管理系统或停车管理平台应符合以下要求：

a)支持向预约共享停车平台提供停车库（场）地理位置（如地址、出入口经纬度）、车位信

息（如车位数量）、收费标准等信息，并符合以下要求：

1)应保证登记的车位信息真实有效，若车位信息变更，应及时维护；

2)应按照登记发布的车位信息提供停车服务，不随意变更。

b)支持电子支付功能；

c)支持发票开具功能；

d)支持对车辆出入事件信息的记录、管理及查询等功能；

e)支持向预约共享停车平台上传车辆的入场信息、出场信息、收费记录等功能；

f)支持对出入停车库（场）的车辆和车位进行采集、记录、认证、监控及管理等功能；

g)支持接收预约共享停车平台的车辆管控名单功能；

h)支持预约车辆费用减免、打折优惠等功能。

6.2预约停车

6.2.1停车库（场）管理系统或停车管理平台应支持接收预约共享停车平台下发的预约停车数据，

包括：

a)预约信息：车辆信息、预约时间等；

b)预约时段变更信息：车辆信息、变更预约时段等；

3

DB4403/T315—2023

c)限时取消预约信息：车辆信息、取消预约等；

d)预约时段与停车时段信息：未按预约订单起始时间进入停车库（场）的处置规则。

6.2.2停车库（场）管理系统或停车管理平台宜支持将预约车辆入口临时调整成非预约车辆入口的

功能。

6.2.3停车库（场）管理系统或停车管理平台宜支持设置停放车辆饱和度的功能。

6.2.4停车库（场）管理系统或停车管理平台应支持开启或关闭预约车辆优先通行功能，并向预约

共享停车平台通知其开启或关闭的状态信息。

6.2.5停车库（场）管理系统或停车管理平台宜支持根据饱和度动态调整流量管控规则保障预约车

辆优先通行的功能。

6.3共享停车

6.3.1停车库（场）管理系统或停车管理平台应向预约共享停车平台上报以下信息：

a)共享方案信息：车位共享方案类型、车型限制、车位停放时段、有效期等；

b)支付结果信息：共享方案订单编号、订单类型、支付结果状态、支付方式等；

c)超时订单信息：共享方案订单编号、超时订单编号、车牌号码、入场时间、出场时间、超

时时间等；

d)退款结果信息：退款流水号、共享方案订单编号、订单类型、退款状态等；

e)订单信息变更信息：共享方案订单编号、订单状态、车牌号码、开始日期、结束日期等。

6.3.2停车库（场）管理系统或停车管理平台应接收预约共享停车平台下发以下信息：

a)共享停车订单信息：车辆信息、共享时段等；

b)共享停车时段变更信息：车辆信息、变更预约时段等；

c)共享停车限时取消信息：车辆信息、取消预约等。

7数据接口要求

7.1概述

停车库（场）管理系统或停车管理平台与预约共享停车平台对接前，服务商向预约共享停车平

台运营方提出接入申请，并进行数据对接。

7.2基础数据类型

基础数据应符合表1的要求，其中停车库（场）编号、车位编号应符合DB4403/T89的要求。

表1基础数据类型清单

类型名称长度基础类（json）说明

StringNaString字符串

Long8字节Number长整型

Int4字节Number整型

Boolean1字节Boolean布尔型

Float4字节Number浮点型

4

DB4403/T315—2023

表1基础数据类型清单（续）

类型名称长度基础类（json）说明

Double8字节Number双精度浮点

Decimal16字节Number高精度浮点

Date10字符String日期，格式“yyyy-MM-dd”

DateTime19字符String日期时间，格式“yyyy-MM-ddHH:mm:ss”

Time8字符String时间，格式“HH:mm:ss”

Timestamp4字节Number时间戳，1970-01-0100:00:00：00起的秒数

Uuid32字符String全球唯一ID

ObjectNbObject对象

ListNbArray数组

注1：未作特殊说明情况下，本文件中涉及的金额统一采用数据类型Decimal，单位为元，精度为小数点后2位。

注2：无特殊说明，本文件中的经纬度均为GCJ-02坐标系坐标。

注3：后文的数据定义中未写明长度的数据类型的字符长度以本表规定为准。

注4：Na表示根据各属性（名称）定义其字符长度，Nb表示引用其他对象。

7.3接口要求

7.3.1协议使用要求

对接要求

停车库（场）管理系统或停车管理平台在对接预约共享停车平台前，按预约共享停车平台的管

理要求，准备信息包括但不限于：

a)注册获取平台服务器地址、对接账号（HTTPS对接的使用的userId/clientId、password

及盐值salt）信息等；

b)向预约共享停车平台提供服务器IP地址（可选）。

基本要求

基本要求如下：

a)传输格式：JSON；

b)编码格式：UTF-8；

c)属性命名规范：小驼峰形式（如：deviceId）；

d)协议要求：HTTPS或MQTT；

e)使用接口一次发送数据的大小不应超过10M字节；

f)预约共享停车平台、停车管理平台采用如NTP时间同步技术和北京时间保持同步；

g)接口请求超时时间限制：20秒以内；

h)请求数据基本格式见表2，应答数据基本格式见表3；

i)编码定义应符合附录C的规定；

j)签名和接口使用示例见附录D。

5

DB4403/T315—2023

表2请求数据基本格式

属性名称数据类型字符长度必须说明

timestamp时间戳Timestamp4是—

签名算法HMACSHA256，key值使用

sign签名String—是平台分配的盐值salt，对data数

据进行签名

data请求数据List<Object>—是根据接口不同请求数据不同

表3应答数据基本格式

属性名称数据类型字符长度必须说明

code系统编码Int—是通用错误编码见表C.1

message系统消息String255否系统编码对应的消息

timestamp时间戳Timestamp—是—

data返回数据List<Object>—是根据接口不同返回数据不同

HTTPS接口要求

HTTPS接口符合以下要求：

a)采用Token机制实现身份认证；Token放到HTTPSheader的Authorization中；

b)接口URL规则：https：//{服务器地址}/sys/{版本号}/event/{接口编码}/post。

示例：https：///sys/v1/event/login/post。

MQTT接口要求

MQTT接口符合以下要求：

a)加密方式：传输加密采用tls证书加密方式；

b)认证方式：使用预约共享停车平台分配的MQTT客户端ID（clientId，标识每个MQTT连接

需要唯一ID）和密码登录消息中间件；

c)服务质量（QoS）：使用默认的QoS等级0；

d)当使用MQTT协议传输数据时：

1)上行符合以下要求：

请求Topic：/sys/{版本号}/event/{接口编码}/post；

响应Topic：/sys/{版本号}/event/{接口编码}/post_reply。

示例：

请求Topic：/sys/v1/event/login/post；

响应Topic：/sys/v1/event/login/post_reply。

2)下行符合以下要求：

请求Topic：/sys/{版本号}/service/{接口编码}/post；

响应Topic：/sys/{版本号}/service/{接口编码}/post_reply。

示例：

请求Topic：/sys/v1/service/requestBookStall/post；

响应Topic：/sys/v1/service/requestBookStall/post_reply。

6

DB4403/T315—2023

7.3.2安全认证接口

登录

安全认证接口的登录应符合以下要求：

a)接口编码：login；

b)场景：停车库（场）管理系统或停车管理平台请求登录预约共享停车平台，平台验证用户

标识，生成Token返回；

c)数据属性：请求数据属性定义见表4，应答数据属性定义见表5。

表4请求数据属性定义

属性名称数据类型字符长度必须说明

userId用户唯一标识String32是—

不使用明文，采用SHA1对原用户

password用户密码String64是

密码加上盐值salt签名后的值

表5应答数据属性定义

属性名称数据类型字符长度必须说明

code消息码Int—否发生错误时为必填，编码见表C.2

message消息详细String255否业务异常信息

scope范围String50否请求的业务范围，默认值basic

tokenType鉴权token类型String50是默认值bearer

accessToken的有效时间，单位：

expiresIn有效时间Int—是

秒

accessToken权限TokenString255是Oauth2.0鉴权参数

refreshToken刷新TokenString255是Oauth2.0鉴权参数

刷新Token

安全认证接口的刷新应符合以下要求：

a)接口编码：refreshToken；

b)场景：accessToken快过期时，停车库（场）管理系统或停车管理平台通过调用此接口，

重新获取可用token。accessToken有效时间按照返回字段expiresIn的值；

c)数据属性：请求数据属性定义见表6，应答数据属性定义见表7。

表6请求数据属性定义

属性名称数据类型字符长度必须说明

userId用户唯一标识String32是预约共享停车平台分配

不使用明文，采用SHA1对原用户

password用户密码String64是

密码加上盐值salt签名后的值

refreshToken刷新TokenString—是—

7

DB4403/T315—2023

表7应答数据属性定义

属性名称数据类型字符长度必须说明

id业务IDUuid32是—

code消息码Int—否发生错误时为必填，编码见表C.2

message消息详细String255否业务异常信息

tokenType鉴权token类型String50是默认值bearer

accessToken的有效时间，单位：

expiresIn有效时间Int—是

秒

accessToken权限TokenString50是Oauth2.0鉴权参数

refreshToken刷新TokenString50是Oauth2.0鉴权参数

登出

安全认证接口的登出应符合以下要求：

a)接口编码：logout；

b)场景：注销Token；

c)数据属性：请求数据属性定义见表8，应答数据属性定义见表9。

表8请求数据属性定义

属性名称数据类型字符长度必须说明

accessToken权限TokenString50是—

表9应答数据属性定义

属性名称数据类型字符长度必须说明

code消息码Int—否发生错误时为必填，编码见表C.2

message消息详细String255否业务异常信息

7.3.3基础数据接口

停车库（场）信息上报

基础数据接口的停车库（场）信息上报应符合以下要求：

a)接口编码：parkInfo；

b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送停车库（场）信息；

c)数据属性：请求数据属性定义见表10，应答数据属性定义见表11。

表10请求数据属性定义

属性名称数据类型字符长度必须说明

停车库（场）编

parkCodeString20是预约共享停车平台提供

号

8

DB4403/T315—2023

表10请求数据属性定义（续）

属性名称数据类型字符长度必须说明

停车库（场）名

parkNameString255是服务商提供

称

由预约共享停车平台分配，涉及共

providerCode服务商编号String100否

享停车应提供

roadName道路名称String10否—

0：路内停车区；

停车库（场）类

parkTypeInt—是1：室内停车场；

型

2：室外停车场

0：否；

isGarage是否有机械车库Int—否

1：是

停车库（场）详

addressString255是停车库（场）详细地址

细地址

经度，服务商上传时应说明数据来

longitude经度Double—是

源

纬度，服务商上传时应说明数据来

latitude纬度Double—是

源

编码规则应符合GB/T2260、GB/T

provinceCode省编码String50是

10114的要求

编码规则应符合GB/T2260、GB/T

cityCode城市编码String50是

10114的要求

编码规则应符合GB/T2260、GB/T

areaCode区域编码String50是

10114的要求

totalSpaces总车位数Int—是总车位数

reservableSpa

总可预约车位数Int—否涉及预约停车业务应提供

ces

totalCharingS

总充电车位数Int—否涉及充电业务应提供

paces

totalReservab

总可预约充电车

leCharingSpacInt—否涉及充电业务应提供

位数

es

总共享停车车位

sharedSpacesInt—否—

数

停车库（场）运由预约共享停车平台统一分配，涉

operatorIdString10否

营方编号及预约停车业务时应提供

针对住宅类

committeeInfo是否有业委会Int