DB4403-T 315-2023 停車庫（場）預約共享數(shù)據(jù)接口規(guī)范

ICS35.240.01

CCSL67

DB4403

深圳市地方標準

DB4403/T315—2023

停車庫（場）預約共享數(shù)據(jù)接口規(guī)范

Specificationforreservationandshareddatainterfaceofparkinglots

2023-02-15發(fā)布2023-03-01實施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/T315—2023

停車庫（場）預約共享數(shù)據(jù)接口規(guī)范

1范圍

本文件規(guī)定了停車庫（場）預約共享停車業(yè)務的總體要求、功能要求、數(shù)據(jù)接口要求、數(shù)據(jù)傳

輸要求。

本文件適用于深圳市范圍內(nèi)停車庫（場）管理系統(tǒng)或停車管理平臺與預約共享停車平臺之間的

數(shù)據(jù)交換以及功能設計與開發(fā)。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用

文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）

適用于本文件。

GB/T2260中華人民共和國行政區(qū)劃代碼

GB5768.2道路交通標志和標線第2部分：道路交通標志

GB/T10114縣級以下行政區(qū)劃代碼編制規(guī)則

GA/T761停車庫（場）安全管理系統(tǒng)技術要求

DB4403/T89智慧停車基礎信息編碼技術規(guī)范

SZJG44停車庫（場）車輛視頻圖像和號牌信息采集與傳輸系統(tǒng)技術要求

3術語和定義

下列術語和定義適用于本文件。

3.1

車位提供方parkingspaceprovider

具有車位產(chǎn)權或使用權，并在一段時間內(nèi)提供車位的組織或個人。

3.2

停車用戶parkingspaceuser

接受停車服務的組織或個人。

3.3

預約停車reservedparking

車位提供方（3.1）向停車用戶（3.2）提供約定時間內(nèi)預約入場或預約到位的服務。

注：停車用戶提前申請、預約才可享受停車服務。

3.4

共享停車sharedparking

車位提供方（3.1）在車位空閑時向停車用戶（3.2）提供停車的服務。

3.5

服務商parkingattendant

為停車庫（場）提供預約共享能力解決方案和經(jīng)營管理服務，協(xié)助停車庫（場）接入預約共享

停車平臺的組織或個人。

1

DB4403/T315—2023

注：服務商包括但不限于停車庫（場）運營（承包）公司、平臺廠商、城市停車運營服務平臺運營方、物業(yè)管

理企業(yè)、工程商/集成商、設備廠商等。

3.6

預約車輛parkingreservationvehicles

向具備預約停車（3.3）的停車庫（場）預約某個時段停車的車輛。

3.7

停車庫（場）管理系統(tǒng)parkinglotsmanagementsystem

對出入停車庫（場）的車輛進行登記、出入認證，監(jiān)控和管理，提供停車庫（場）區(qū)內(nèi)引導、

尋找車輛等一系列功能的電子系統(tǒng)或網(wǎng)絡。

3.8

停車管理平臺parkingmanagementplatform

用于對路內(nèi)停車泊位或路外停車場進行統(tǒng)一運營、監(jiān)控和運維管理的系統(tǒng)或平臺。

3.9

預約共享停車平臺reservationandsharedparkingplatform

運用物聯(lián)網(wǎng)、云計算、大數(shù)據(jù)等技術，通過與第三方停車、充電、機械車庫等系統(tǒng)或平臺的對

接，獲取、處理停車庫（場）停車信息，將各停車資源互聯(lián)互通實現(xiàn)停車資源共享、一賬通行等，

對向社會大眾提供目標區(qū)域范圍內(nèi)車位尋找、車位引導、預約停車（3.3）、共享停車（3.4）等服

務的系統(tǒng)。

3.10

流量管控flowcontrol

根據(jù)停車庫（場）內(nèi)剩余車位數(shù)，動態(tài)調(diào)整入場車輛的放行規(guī)則。

3.11

飽和度saturation

停車庫（場）內(nèi)停放車輛數(shù)與總車位數(shù)的比值。

注：總車位數(shù)指可用于預約和非預約車輛停放的車位總數(shù)。

4縮略語

下列縮略語適用于本文件。

APP：應用程序（Application）

HMACSHA256：使用安全哈希算法256的消息認證碼（Hash-basedMessageAuthenticationCode-

SecureHashAlgorithm256）

HTTPS：安全套接字層的超文本傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocket

Layer）

ID：標識編碼（Identification）

MQTT：消息隊列遙測傳輸（MessageQueuingTelemetryTransport）

NTP：網(wǎng)絡時間協(xié)議（NetworkTimeProtocol）

QoS：服務質(zhì)量（QualityofService）

5總體要求

5.1具備預約共享業(yè)務功能的停車庫（場）建設應符合附錄A的規(guī)定。

2

DB4403/T315—2023

5.2預約共享停車平臺與各停車庫（場）管理系統(tǒng)或停車管理平臺進行數(shù)據(jù)對接，預約共享停車業(yè)

務示意圖見圖1，具體接入方式如下：

a)預約停車資源或共享停車資源通過停車管理平臺接入預約共享停車平臺進行數(shù)據(jù)交互；

b)預約停車資源或共享停車資源通過停車庫（場）管理系統(tǒng)接入預約共享停車平臺進行數(shù)據(jù)

交互。

預約停車

資源

停車管理平臺

共享停車

資源

預約共享停車平臺停車用戶

預約停車

資源

停車庫（場）管理系

統(tǒng)

共享停車

資源

車位提供方服務商平臺運營方用戶端

注：實線框表示在本文件界定的范圍。

圖1預約共享停車業(yè)務示意圖

5.3當產(chǎn)生共享停車業(yè)務或預約停車業(yè)務時，停車業(yè)務場景及流程見附錄B。

6功能要求

6.1通用要求

接入預約共享停車平臺的停車庫（場）管理系統(tǒng)或停車管理平臺應符合以下要求：

a)支持向預約共享停車平臺提供停車庫（場）地理位置（如地址、出入口經(jīng)緯度）、車位信

息（如車位數(shù)量）、收費標準等信息，并符合以下要求：

1)應保證登記的車位信息真實有效，若車位信息變更，應及時維護；

2)應按照登記發(fā)布的車位信息提供停車服務，不隨意變更。

b)支持電子支付功能；

c)支持發(fā)票開具功能；

d)支持對車輛出入事件信息的記錄、管理及查詢等功能；

e)支持向預約共享停車平臺上傳車輛的入場信息、出場信息、收費記錄等功能；

f)支持對出入停車庫（場）的車輛和車位進行采集、記錄、認證、監(jiān)控及管理等功能；

g)支持接收預約共享停車平臺的車輛管控名單功能；

h)支持預約車輛費用減免、打折優(yōu)惠等功能。

6.2預約停車

6.2.1停車庫（場）管理系統(tǒng)或停車管理平臺應支持接收預約共享停車平臺下發(fā)的預約停車數(shù)據(jù)，

包括：

a)預約信息：車輛信息、預約時間等；

b)預約時段變更信息：車輛信息、變更預約時段等；

3

DB4403/T315—2023

c)限時取消預約信息：車輛信息、取消預約等；

d)預約時段與停車時段信息：未按預約訂單起始時間進入停車庫（場）的處置規(guī)則。

6.2.2停車庫（場）管理系統(tǒng)或停車管理平臺宜支持將預約車輛入口臨時調(diào)整成非預約車輛入口的

功能。

6.2.3停車庫（場）管理系統(tǒng)或停車管理平臺宜支持設置停放車輛飽和度的功能。

6.2.4停車庫（場）管理系統(tǒng)或停車管理平臺應支持開啟或關閉預約車輛優(yōu)先通行功能，并向預約

共享停車平臺通知其開啟或關閉的狀態(tài)信息。

6.2.5停車庫（場）管理系統(tǒng)或停車管理平臺宜支持根據(jù)飽和度動態(tài)調(diào)整流量管控規(guī)則保障預約車

輛優(yōu)先通行的功能。

6.3共享停車

6.3.1停車庫（場）管理系統(tǒng)或停車管理平臺應向預約共享停車平臺上報以下信息：

a)共享方案信息：車位共享方案類型、車型限制、車位停放時段、有效期等；

b)支付結果信息：共享方案訂單編號、訂單類型、支付結果狀態(tài)、支付方式等；

c)超時訂單信息：共享方案訂單編號、超時訂單編號、車牌號碼、入場時間、出場時間、超

時時間等；

d)退款結果信息：退款流水號、共享方案訂單編號、訂單類型、退款狀態(tài)等；

e)訂單信息變更信息：共享方案訂單編號、訂單狀態(tài)、車牌號碼、開始日期、結束日期等。

6.3.2停車庫（場）管理系統(tǒng)或停車管理平臺應接收預約共享停車平臺下發(fā)以下信息：

a)共享停車訂單信息：車輛信息、共享時段等；

b)共享停車時段變更信息：車輛信息、變更預約時段等；

c)共享停車限時取消信息：車輛信息、取消預約等。

7數(shù)據(jù)接口要求

7.1概述

停車庫（場）管理系統(tǒng)或停車管理平臺與預約共享停車平臺對接前，服務商向預約共享停車平

臺運營方提出接入申請，并進行數(shù)據(jù)對接。

7.2基礎數(shù)據(jù)類型

基礎數(shù)據(jù)應符合表1的要求，其中停車庫（場）編號、車位編號應符合DB4403/T89的要求。

表1基礎數(shù)據(jù)類型清單

類型名稱長度基礎類（json）說明

StringNaString字符串

Long8字節(jié)Number長整型

Int4字節(jié)Number整型

Boolean1字節(jié)Boolean布爾型

Float4字節(jié)Number浮點型

4

DB4403/T315—2023

表1基礎數(shù)據(jù)類型清單（續(xù)）

類型名稱長度基礎類（json）說明

Double8字節(jié)Number雙精度浮點

Decimal16字節(jié)Number高精度浮點

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

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

Time8字符String時間，格式“HH:mm:ss”

Timestamp4字節(jié)Number時間戳，1970-01-0100:00:00：00起的秒數(shù)

Uuid32字符String全球唯一ID

ObjectNbObject對象

ListNbArray數(shù)組

注1：未作特殊說明情況下，本文件中涉及的金額統(tǒng)一采用數(shù)據(jù)類型Decimal，單位為元，精度為小數(shù)點后2位。

注2：無特殊說明，本文件中的經(jīng)緯度均為GCJ-02坐標系坐標。

注3：后文的數(shù)據(jù)定義中未寫明長度的數(shù)據(jù)類型的字符長度以本表規(guī)定為準。

注4：Na表示根據(jù)各屬性（名稱）定義其字符長度，Nb表示引用其他對象。

7.3接口要求

7.3.1協(xié)議使用要求

對接要求

停車庫（場）管理系統(tǒng)或停車管理平臺在對接預約共享停車平臺前，按預約共享停車平臺的管

理要求，準備信息包括但不限于：

a)注冊獲取平臺服務器地址、對接賬號（HTTPS對接的使用的userId/clientId、password

及鹽值salt）信息等；

b)向預約共享停車平臺提供服務器IP地址（可選）。

基本要求

基本要求如下：

a)傳輸格式：JSON；

b)編碼格式：UTF-8；

c)屬性命名規(guī)范：小駝峰形式（如：deviceId）；

d)協(xié)議要求：HTTPS或MQTT；

e)使用接口一次發(fā)送數(shù)據(jù)的大小不應超過10M字節(jié)；

f)預約共享停車平臺、停車管理平臺采用如NTP時間同步技術和北京時間保持同步；

g)接口請求超時時間限制：20秒以內(nèi)；

h)請求數(shù)據(jù)基本格式見表2，應答數(shù)據(jù)基本格式見表3；

i)編碼定義應符合附錄C的規(guī)定；

j)簽名和接口使用示例見附錄D。

5

DB4403/T315—2023

表2請求數(shù)據(jù)基本格式

屬性名稱數(shù)據(jù)類型字符長度必須說明

timestamp時間戳Timestamp4是—

簽名算法HMACSHA256，key值使用

sign簽名String—是平臺分配的鹽值salt，對data數(shù)

據(jù)進行簽名

data請求數(shù)據(jù)List<Object>—是根據(jù)接口不同請求數(shù)據(jù)不同

表3應答數(shù)據(jù)基本格式

屬性名稱數(shù)據(jù)類型字符長度必須說明

code系統(tǒng)編碼Int—是通用錯誤編碼見表C.1

message系統(tǒng)消息String255否系統(tǒng)編碼對應的消息

timestamp時間戳Timestamp—是—

data返回數(shù)據(jù)List<Object>—是根據(jù)接口不同返回數(shù)據(jù)不同

HTTPS接口要求

HTTPS接口符合以下要求：

a)采用Token機制實現(xiàn)身份認證；Token放到HTTPSheader的Authorization中；

b)接口URL規(guī)則：https：//{服務器地址}/sys/{版本號}/event/{接口編碼}/post。

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

MQTT接口要求

MQTT接口符合以下要求：

a)加密方式：傳輸加密采用tls證書加密方式；

b)認證方式：使用預約共享停車平臺分配的MQTT客戶端ID（clientId，標識每個MQTT連接

需要唯一ID）和密碼登錄消息中間件；

c)服務質(zhì)量（QoS）：使用默認的QoS等級0；

d)當使用MQTT協(xié)議傳輸數(shù)據(jù)時：

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)場景：停車庫（場）管理系統(tǒng)或停車管理平臺請求登錄預約共享停車平臺，平臺驗證用戶

標識，生成Token返回；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表4，應答數(shù)據(jù)屬性定義見表5。

表4請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

userId用戶唯一標識String32是—

不使用明文，采用SHA1對原用戶

password用戶密碼String64是

密碼加上鹽值salt簽名后的值

表5應答數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

code消息碼Int—否發(fā)生錯誤時為必填，編碼見表C.2

message消息詳細String255否業(yè)務異常信息

scope范圍String50否請求的業(yè)務范圍，默認值basic

tokenType鑒權token類型String50是默認值bearer

accessToken的有效時間，單位：

expiresIn有效時間Int—是

秒

accessToken權限TokenString255是Oauth2.0鑒權參數(shù)

refreshToken刷新TokenString255是Oauth2.0鑒權參數(shù)

刷新Token

安全認證接口的刷新應符合以下要求：

a)接口編碼：refreshToken；

b)場景：accessToken快過期時，停車庫（場）管理系統(tǒng)或停車管理平臺通過調(diào)用此接口，

重新獲取可用token。accessToken有效時間按照返回字段expiresIn的值；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表6，應答數(shù)據(jù)屬性定義見表7。

表6請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

userId用戶唯一標識String32是預約共享停車平臺分配

不使用明文，采用SHA1對原用戶

password用戶密碼String64是

密碼加上鹽值salt簽名后的值

refreshToken刷新TokenString—是—

7

DB4403/T315—2023

表7應答數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

id業(yè)務IDUuid32是—

code消息碼Int—否發(fā)生錯誤時為必填，編碼見表C.2

message消息詳細String255否業(yè)務異常信息

tokenType鑒權token類型String50是默認值bearer

accessToken的有效時間，單位：

expiresIn有效時間Int—是

秒

accessToken權限TokenString50是Oauth2.0鑒權參數(shù)

refreshToken刷新TokenString50是Oauth2.0鑒權參數(shù)

登出

安全認證接口的登出應符合以下要求：

a)接口編碼：logout；

b)場景：注銷Token；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表8，應答數(shù)據(jù)屬性定義見表9。

表8請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

accessToken權限TokenString50是—

表9應答數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

code消息碼Int—否發(fā)生錯誤時為必填，編碼見表C.2

message消息詳細String255否業(yè)務異常信息

7.3.3基礎數(shù)據(jù)接口

停車庫（場）信息上報

基礎數(shù)據(jù)接口的停車庫（場）信息上報應符合以下要求：

a)接口編碼：parkInfo；

b)場景：停車庫（場）管理系統(tǒng)或停車管理平臺調(diào)用接口主動推送停車庫（場）信息；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表10，應答數(shù)據(jù)屬性定義見表11。

表10請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

停車庫（場）編

parkCodeString20是預約共享停車平臺提供

號

8

DB4403/T315—2023

表10請求數(shù)據(jù)屬性定義（續(xù)）

屬性名稱數(shù)據(jù)類型字符長度必須說明

停車庫（場）名

parkNameString255是服務商提供

稱

由預約共享停車平臺分配，涉及共

providerCode服務商編號String100否

享停車應提供

roadName道路名稱String10否—

0：路內(nèi)停車區(qū)；

停車庫（場）類

parkTypeInt—是1：室內(nèi)停車場；

型

2：室外停車場

0：否；

isGarage是否有機械車庫Int—否

1：是

停車庫（場）詳

addressString255是停車庫（場）詳細地址

細地址

經(jīng)度，服務商上傳時應說明數(shù)據(jù)來

longitude經(jīng)度Double—是

源

緯度，服務商上傳時應說明數(shù)據(jù)來

latitude緯度Double—是

源

編碼規(guī)則應符合GB/T2260、GB/T

provinceCode省編碼String50是

10114的要求

編碼規(guī)則應符合GB/T2260、GB/T

cityCode城市編碼String50是

10114的要求

編碼規(guī)則應符合GB/T2260、GB/T

areaCode區(qū)域編碼String50是

10114的要求

totalSpaces總車位數(shù)Int—是總車位數(shù)

reservableSpa

總可預約車位數(shù)Int—否涉及預約停車業(yè)務應提供

ces

totalCharingS

總充電車位數(shù)Int—否涉及充電業(yè)務應提供

paces

totalReservab

總可預約充電車

leCharingSpacInt—否涉及充電業(yè)務應提供

位數(shù)

es

總共享停車車位

sharedSpacesInt—否—

數(shù)

停車庫（場）運由預約共享停車平臺統(tǒng)一分配，涉

operatorIdString10否

營方編號及預約停車業(yè)務時應提供

針對住宅類

committeeInfo是否有業(yè)委會Int—否0：是；

1：否

9

DB4403/T315—2023

表10請求數(shù)據(jù)屬性定義（續(xù)）

屬性名稱數(shù)據(jù)類型字符長度必須說明

publicInfo經(jīng)營信息String200否經(jīng)營時間（如6:00～8:00）

1：商業(yè)；

2：住宅；

3：醫(yī)院；

4：園區(qū)；

serviceType服務屬性Int—否

5：交通樞紐；

6：行政機關；

7：學校；

8：其它

示例：免費時長30分鐘，首小時

chargingStand

收費標準描述String255是10元，后每小時5元，每24小時

ardDesc

封頂60元

停車庫（場）收圖片URL訪問地址，見.7

imageUrlString255否

費牌圖片圖片上傳接口

停車庫（場）電圖片URL訪問地址，見.7

mapImageString255否

子平面圖圖片上傳接口

parkingSpaceI圖片URL訪問地址，見.7

車位分布圖String255否

mage圖片上傳接口

contacts聯(lián)系人String50否停車庫（場）聯(lián)系人

tel聯(lián)系電話String20否停車庫（場）聯(lián)系電話

停車庫（場）使用狀態(tài)：

bizStatus狀態(tài)Int—否0：禁用；

1：啟用

remark備注字段String255否備注字段

表11應答數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

parkCode停車庫（場）編號String20是—

code消息碼Int—否發(fā)生錯誤時為必填，編碼見表C.2

message消息詳細String255否業(yè)務異常信息

isvParkId平臺車場IDString50是預約共享停車平臺生成

出入口信息上報

基礎數(shù)據(jù)接口的出入口信息上報應符合以下要求：

a)接口編碼：entranceExitInfo；

b)場景：停車庫（場）管理系統(tǒng)或停車管理平臺調(diào)用接口主動推送出入口信息；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表12，應答數(shù)據(jù)屬性定義見表13。

10

DB4403/T315—2023

表12請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

id出入口IDUuid32是停車庫（場）的出入口ID

name名稱String10是—

停車庫（場）編

parkCodeString20是—

號

roadName道路名稱String10否—

1：入口；

type出入口類型Int—是2：出口；

3：出入口

經(jīng)度，服務商上傳時應說明數(shù)據(jù)來

longitude經(jīng)度Double—是

源

緯度，服務商上傳時應說明數(shù)據(jù)來

latitude緯度Double—是

源

1：正常；

status狀態(tài)Int—是2：刪除；

3：臨時封閉（故障、管制等）

表13應答數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

id出入口IDUuid32是停車庫（場）的出入口ID

code消息碼Int—否發(fā)生錯誤時為必填，編碼見表C.2

message消息詳細String255否業(yè)務異常信息

車位基礎信息上報

基礎數(shù)據(jù)接口的車位基礎信息上報應符合以下要求：

a)接口編碼：spaceInfo；

b)場景：停車庫（場）管理系統(tǒng)或停車管理平臺調(diào)用接口主動推送車位基礎信息；

c)數(shù)據(jù)屬性：請求數(shù)據(jù)屬性定義見表14，應答數(shù)據(jù)屬性定義見表15。

表14請求數(shù)據(jù)屬性定義

屬性名稱數(shù)據(jù)類型字符長度必須說明

idIDString—是—

spaceNo車位編號String28是車位方格內(nèi)的編號

停車庫（場）編

parkCodeString20是—

號

11

DB4403/T315—2023

表14請求數(shù)據(jù)屬性定義（續(xù)）

屬性名稱數(shù)據(jù)類型字符長度必須說明

0：分時；

1：長期包月；

manageType經(jīng)營類型Int—否2：限時段包月；

3：已售；

4：專用車位（如消防）

1：個人；

ownerType產(chǎn)權類型Int—否2：單位；

3：其他

0：路內(nèi)；

positionType位置類型Int—是1：停車庫；

2：停車場

車位分類【長（毫米）×寬（毫

米）】：

1：小型：4000×2200；

sizeType尺寸類型Int—否

2：中型：5000×2500；

3：大型：15600×3250；

4：子母車位：10000×2500

長（毫米）×寬（毫米）×高（毫

spaceSize車位尺寸String—否

米），不限高度車位，高度為0

1：商業(yè)；

2：住宅；

3：醫(yī)院；

4：園區(qū)；

serviceType服務屬性Int—否

5：交通樞紐；

6：行政機關；