常州智慧停車服務(wù)與管理信息系統(tǒng)接入規(guī)范標(biāo)準(zhǔn)

1、常州智慧停車服務(wù)與管理信息系統(tǒng)接入規(guī)范擬制人：審核人：批準(zhǔn)人:文件變更記錄增加-修訂-刪除版本號(hào)日期變更類型修改人摘要審核人備注城市代碼改為必填支付完成通知接口增加返回查價(jià)接口得到的計(jì)費(fèi)時(shí)間收費(fèi)記錄上傳接口顯示上支付渠道字段，由改為心跳接口增加頻率說明增加和的說明接口類型由調(diào)整為調(diào)整為增加字段類型增加數(shù)據(jù)補(bǔ)傳機(jī)制說明目錄引言錯(cuò)誤！未指定書簽編寫目的錯(cuò)誤！未指定書簽范圍錯(cuò)誤！未指定書簽術(shù)語定義錯(cuò)誤！未指定書簽平臺(tái)交互流程錯(cuò)誤！未指定書簽移動(dòng)支付臨停費(fèi)用交互流程錯(cuò)誤！未指定書簽其它數(shù)據(jù)交互錯(cuò)誤！未指定書簽停車場(chǎng)接入云平臺(tái)流程錯(cuò)誤！未指定書簽停車場(chǎng)申請(qǐng)接入信息錯(cuò)誤！未指定書簽停車場(chǎng)廠商開發(fā)通信協(xié)議錯(cuò)

2、誤！未指定書簽停車場(chǎng)廠商接入測(cè)試服務(wù)器地址錯(cuò)誤！未指定書簽停車場(chǎng)廠商接入正式服務(wù)器地址錯(cuò)誤！未指定書簽接口調(diào)用規(guī)范錯(cuò)誤！未指定書簽?zāi)J(rèn)請(qǐng)求參數(shù)錯(cuò)誤！未指定書簽接口約定錯(cuò)誤！未指定書簽簽名算法錯(cuò)誤！未指定書簽例子錯(cuò)誤！未指定書簽接口定義錯(cuò)誤！未指定書簽接口總覽錯(cuò)誤！未指定書簽基礎(chǔ)數(shù)據(jù)對(duì)接錯(cuò)誤！未指定書簽車場(chǎng)信息同步錯(cuò)誤！未指定書簽空車位數(shù)上傳接口錯(cuò)誤！未指定書簽通行數(shù)據(jù)對(duì)接錯(cuò)誤！未指定書簽進(jìn)出記錄上傳錯(cuò)誤！未指定書簽收費(fèi)記錄上傳進(jìn)出記錄圖片接口 臨停收費(fèi)對(duì)接臨停計(jì)費(fèi)查詢 臨停支付完成通知 心跳接口 心跳接口 數(shù)據(jù)字典定義 錯(cuò)誤！未指定書簽 錯(cuò)誤！未指定書簽 錯(cuò)誤！未指定書簽 錯(cuò)誤！未指定書簽 錯(cuò)

3、誤！未指定書簽 錯(cuò)誤！未指定書簽 錯(cuò)誤！未指定書簽錯(cuò)誤！未指定書簽車牌顏色支付方式車輛類型收費(fèi)方式錯(cuò)誤！未指定書簽錯(cuò)誤！未指定書簽錯(cuò)誤！未指定書簽錯(cuò)誤！未指定書簽錯(cuò)誤！未指定書簽部分請(qǐng)求實(shí)例1引言1.1 編寫目的主要描述了第三方停車場(chǎng)系統(tǒng)接入常州智慧停車服務(wù)與管理信息系統(tǒng)（以下簡(jiǎn)稱“云平臺(tái)”）需要的接口和數(shù)據(jù)定義，為第三方停車場(chǎng)系統(tǒng)對(duì)接云平臺(tái)提供接口依據(jù)。1.2 范圍本詳細(xì)設(shè)計(jì)說明書的預(yù)期讀者為：?項(xiàng)目開發(fā)人員。?項(xiàng)目測(cè)試人員。?軟件維護(hù)人員。1.3 術(shù)語定義術(shù)語、縮略語解釋即（信息摘要算法），用于確保信息傳輸完整一致。是計(jì)算機(jī)廣泛使用的雜湊算法之一（又譯摘要算法、哈希算法）。上行下行上行指停

4、車場(chǎng)系統(tǒng)調(diào)用云平臺(tái)接口，向云平臺(tái)傳輸數(shù)據(jù)或者業(yè)務(wù)。下行指云平臺(tái)調(diào)用停車場(chǎng)系統(tǒng)接口，向停車場(chǎng)系統(tǒng)傳輸數(shù)據(jù)或者業(yè)務(wù)。2平臺(tái)交互流程2.1移動(dòng)支付臨停費(fèi)用交互流程本交互流程描述的功能為：在常州智慧停車微信公眾號(hào)或中，通過移動(dòng)支付的方式，支付第三方車場(chǎng)臨停費(fèi)用，具體流程說明如下：1、臨停收費(fèi)規(guī)則由第三方本地車場(chǎng)系統(tǒng)自行制定，云平臺(tái)不進(jìn)行干涉；2、使用現(xiàn)金支付時(shí)，本地車場(chǎng)系統(tǒng)直接調(diào)用本地車場(chǎng)服務(wù)端計(jì)算費(fèi)用，完成支付后將賬單明細(xì)同步到云平臺(tái)；3、線上支付停車費(fèi)時(shí)，云平臺(tái)需要向本地車場(chǎng)請(qǐng)求計(jì)費(fèi)，由本地車場(chǎng)返回賬單信息；4、線上支付完成后，通知本地車場(chǎng)，完成賬單，并告知本地車場(chǎng)是否有優(yōu)惠情況；5、本地車場(chǎng)完成

5、賬單后需要把賬單明細(xì)同步到云平臺(tái)；車主APP、微信公眾號(hào)等線上支付服務(wù)輸入車牌 請(qǐng)求賬單上傳優(yōu)惠后賬單支忖成功 返回支付 金額及優(yōu)傳車牌. 請(qǐng)求賬單上傳賬單常州智慧停乍服務(wù)與管理信息系統(tǒng)支付成功返回支付金額及優(yōu)|惠.第三方本地車場(chǎng)系統(tǒng)2.2其它數(shù)據(jù)交互常州智慧停車服務(wù)與管理信息系統(tǒng)車場(chǎng)信息空車位數(shù)進(jìn)出記錄進(jìn)出記錄圖片收費(fèi)記錄第三方本地車場(chǎng)系統(tǒng)3停車場(chǎng)接入云平臺(tái)流程3.1停車場(chǎng)申請(qǐng)接入信息停車場(chǎng)廠商向云平臺(tái)申請(qǐng)接入，我方將提供以下數(shù)據(jù)1、合作方應(yīng)用標(biāo)識(shí)。2、云平臺(tái)版本信息。3、云平臺(tái)驗(yàn)證加密密鑰。4、測(cè)試服務(wù)器地址：待定5、正式服務(wù)器地址：待定。3.2 停車場(chǎng)廠商開發(fā)通信協(xié)議停車場(chǎng)調(diào)用云平臺(tái)使用

6、協(xié)議進(jìn)行接口調(diào)用。具體規(guī)范參照：接口調(diào)用規(guī)范。3.3 停車場(chǎng)廠商接入測(cè)試服務(wù)器地址我方將提供測(cè)試服務(wù)器用以進(jìn)行接入調(diào)試。接入服務(wù)器地址：待定3.4 停車場(chǎng)廠商接入正式服務(wù)器地址接入服務(wù)器地址：待定。4接口調(diào)用規(guī)范4.1 默認(rèn)請(qǐng)求參數(shù)默認(rèn)參數(shù)是指在所有請(qǐng)求中都必須攜帶的參數(shù)中，默認(rèn)參數(shù)以方式傳遞。字段描述備注停車場(chǎng)應(yīng)用標(biāo)識(shí)，由云平臺(tái)統(tǒng)一分配每個(gè)停車場(chǎng)分配唯個(gè)時(shí)間戳，單位秒至今秒數(shù)版本默認(rèn)密鑰，由云平臺(tái)統(tǒng)一分配不傳遞，只為簽名，作鑒權(quán)之用。詳細(xì)生成方式見4.2 接口約定1 .請(qǐng)求編碼，中文需要編碼2 .使用加密算法4.3 簽名算法將所有業(yè)務(wù)參數(shù)組裝為格式字符串，與、按字典序排序后拼接成字符串，然后

7、該字符串進(jìn)行加密生成。注意：參數(shù)連接時(shí)需按參數(shù)名升序排序，輸出結(jié)果為小寫。拼接字符串時(shí)，參數(shù)要進(jìn)行編碼。()()()()4.4 例子云平臺(tái)獲取的配置固定參數(shù)<,>();("","");("","");("","");需要的數(shù)據(jù)<,>();("",);("","你好)("",);();的數(shù)據(jù)源<,>();();("",);給進(jìn)行排序，并對(duì)編碼<&g

8、t;();(<,>:()()(),"");<,>();("")("")();結(jié)果：加密("");結(jié)果：最終地址("",);云平臺(tái)地址("")("")()；的數(shù)據(jù)結(jié)果：5接口定義5.1 接口總覽實(shí)現(xiàn)內(nèi)容模塊功能點(diǎn)接口保證雙方通訊心跳接口P監(jiān)測(cè)在線心跳接口實(shí)現(xiàn)基本業(yè)務(wù)數(shù)據(jù)交互，引止常運(yùn)行基礎(chǔ)數(shù)據(jù)對(duì)接車場(chǎng)信息車場(chǎng)信息同步接口空車位數(shù)上傳空車位數(shù)上傳接口通行數(shù)據(jù)對(duì)接進(jìn)出記錄進(jìn)出記錄上傳收費(fèi)記錄收費(fèi)記錄上傳進(jìn)出記錄圖片進(jìn)出記錄圖片接口臨停收費(fèi)

9、對(duì)接臨停計(jì)費(fèi)臨停計(jì)費(fèi)查詢臨停支付完成通知5.2 數(shù)據(jù)補(bǔ)傳機(jī)制（重要）當(dāng)系統(tǒng)出現(xiàn)網(wǎng)絡(luò)中斷、接口故障或其他情況導(dǎo)致第三方停車場(chǎng)系統(tǒng)與云平臺(tái)之前通訊出現(xiàn)異常，數(shù)據(jù)交互失敗，第三方停車場(chǎng)系統(tǒng)需建立數(shù)據(jù)補(bǔ)傳機(jī)制。通過上行心跳接口監(jiān)測(cè)（監(jiān)測(cè)頻率分鐘），當(dāng)心跳接口不通時(shí)，中斷數(shù)據(jù)上傳；當(dāng)心跳接口正常后，補(bǔ)傳未上傳數(shù)據(jù)和上傳失敗數(shù)據(jù)，直至全部數(shù)據(jù)上傳成功。5.3 心跳接口5.3.1 心跳接口接口類型：接口說明：車場(chǎng)和平臺(tái)均需要此接口來相互檢測(cè)是否在線，包含上行心跳接口和下行心跳接口。上行心跳接口頻率為分鐘。接口地址：上行服務(wù)地址：云平臺(tái)地址下行服務(wù)地址：廠商車場(chǎng)系統(tǒng)地址參數(shù)類型：字符串參數(shù)說明：屬性名稱說明固

10、定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串E傳遞時(shí)間戳字符串方式傳遞簽名字符串E傳遞業(yè)務(wù)參數(shù)返回結(jié)果”"":"""":5.4 基礎(chǔ)數(shù)據(jù)對(duì)接車場(chǎng)需要將車場(chǎng)的基本信息同步給云平臺(tái)，例如車場(chǎng)名、地址、收費(fèi)標(biāo)準(zhǔn)、實(shí)時(shí)空余車位數(shù)等。5.4.1 車場(chǎng)信息同步接口類型：接口說明：修改車場(chǎng)基本信息：如名稱、地址、收費(fèi)標(biāo)準(zhǔn)接口地址：上行服務(wù)地址：云平臺(tái)地址參數(shù)類型：字符串參數(shù)說明:屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串E傳遞時(shí)間戳字符串方式傳遞簽名字符串方式傳遞業(yè)務(wù)參數(shù)車場(chǎng)名稱字符串（）必填地址字符串（）收費(fèi)標(biāo)準(zhǔn)字符串（）必填城市代碼字符串（）必

11、填參照中華人民共和國國家統(tǒng)計(jì)局網(wǎng)站發(fā)布的行政區(qū)劃代碼經(jīng)度浮點(diǎn)數(shù)（）國測(cè)局（）坐標(biāo)緯度浮點(diǎn)數(shù)（）國測(cè)局（）坐標(biāo)返回結(jié)果Illi."":""."":5.4.2 空車位數(shù)上傳接口接口類型：接口說明：每隔秒，廠商主動(dòng)上傳一次最新的空車位數(shù)接口地址：上行服務(wù)地址：云平臺(tái)地址參數(shù)類型：字符串屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串E傳遞時(shí)間戳字符串方式傳遞簽名字符串方式傳遞業(yè)務(wù)參數(shù)空車位數(shù)整型（）必填總車位數(shù)整型（）必填返回結(jié)果”"":""."":5.5 通行數(shù)據(jù)對(duì)接車場(chǎng)需要將

12、車輛的進(jìn)出記錄，收費(fèi)記錄上傳給云平臺(tái)。5.5.1 進(jìn)出記錄上傳接口類型：接口說明：新增或更新進(jìn)出記錄。車場(chǎng)需要向平臺(tái)實(shí)時(shí)上傳車輛進(jìn)出記錄。接口地址：上行服務(wù)地址：云平臺(tái)地址參數(shù)類型：字符串屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串E傳遞時(shí)間戳字符串方式傳遞簽名字符串E傳遞業(yè)務(wù)參數(shù)進(jìn)出記錄標(biāo)識(shí)整型（）必填主鍵入場(chǎng)和出場(chǎng)必須是/、同的通行時(shí)間日期時(shí)間必填格式：車牌號(hào)字符串（）必填車牌顏色整型（）必填具體見說明是否人工確認(rèn)過車牌整型（）否；是對(duì)應(yīng)收費(fèi)記錄標(biāo)識(shí)整型（）多次收費(fèi)記錄的，上傳最舟-次收費(fèi)記錄的標(biāo)識(shí)記錄類型整型（）必填入場(chǎng)，出場(chǎng)返回結(jié)果”"":"&quo

13、t;."":5.5.2 收費(fèi)記錄上傳接口類型：接口說明：新增或更新收費(fèi)記錄。車場(chǎng)需要向平臺(tái)實(shí)時(shí)上傳車輛收費(fèi)記錄。包含收費(fèi)金額為的記錄，如月卡車等。接口地址：上行服務(wù)地址：云平臺(tái)地址參數(shù)類型：字符串屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串方式傳遞時(shí)間戳字符串r方式傳遞簽名字符串方式傳遞業(yè)務(wù)參數(shù)收費(fèi)記錄整型。必填主鍵一次停車分多次支付，每次支付的不得重復(fù)收費(fèi)時(shí)間日期時(shí)間必填格式：車牌號(hào)字符串（）必填車牌顏色整型（）必填具體見說明開始時(shí)間日期時(shí)間必填入場(chǎng)時(shí)間格式：結(jié)束時(shí)間日期時(shí)間必填添加賬單時(shí)間格式：收費(fèi)方式整型（）必填具體見說明支付方式整型（）必填具體見說明線上支付渠

14、道整形（）必填:現(xiàn)金支付:第三方線上支付收費(fèi)（即車場(chǎng)自有渠道線上支付）:常州智慧停車線上收費(fèi)（即云平臺(tái)線上支付）應(yīng)收浮點(diǎn)數(shù)（）必填單位（元）實(shí)收浮點(diǎn)數(shù)（）必填單位（元）車輛類型整型（）具體見說明優(yōu)惠金額浮點(diǎn)數(shù)（）單位（元）:使用充值金額浮點(diǎn)數(shù)（）P單位（元）提前收費(fèi)金額浮點(diǎn)數(shù)（）單位（元）提前收費(fèi)金額指出場(chǎng)前本次進(jìn)出記錄已經(jīng)收費(fèi)的金額:會(huì)員卡優(yōu)惠金額浮點(diǎn)數(shù)（）單位（元）固定用戶按臨停計(jì)算的優(yōu)惠金額浮點(diǎn)數(shù)（）單位（元）如果按臨停計(jì)費(fèi)，賬單的優(yōu)惠金額賬單編號(hào)字符串（）如果使用或者其他非現(xiàn)金支付方式，需要保留第二方支付賬單編號(hào)電子優(yōu)惠券編號(hào)字符串（）同時(shí)使用到多張電子優(yōu)惠券時(shí)，將編號(hào)以英文半角逗號(hào)形

15、式連接備注信息字符串返回結(jié)果Illi.Illi"":5.5.3 進(jìn)出記錄圖片接口接口類型:接口說明：廠商主動(dòng)上傳每條停車記錄的圖片，注意此接口為請(qǐng)求，在固定參數(shù)中傳遞圖片文件流。接口地址：上行服務(wù)地址：云平臺(tái)地址參數(shù)類型：字符串屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串方式傳遞時(shí)間戳字符串r方式傳遞簽名字符串E傳遞圖片文件流文件流方式傳遞，請(qǐng)求頭為：業(yè)務(wù)參數(shù)進(jìn)出記錄標(biāo)識(shí)整型（）必填需要獲取對(duì)應(yīng)圖片的進(jìn)出記錄的記錄圖片的類型整型（）必填車牌小圖車身圖返回結(jié)果1111.Illi.11111111.5.6 臨停收費(fèi)對(duì)接云平臺(tái)與停車場(chǎng)系統(tǒng)進(jìn)行臨停收費(fèi)相關(guān)功能的對(duì)接。5.6.

16、1 臨停計(jì)費(fèi)查詢接口類型：接口說明：車場(chǎng)系統(tǒng)需要提供本地的臨停計(jì)費(fèi)接口，供平臺(tái)進(jìn)行調(diào)用。接口地址:下行服務(wù)地址：廠商車場(chǎng)系統(tǒng)地址參數(shù)類型：字符串參數(shù)說明:屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串方式傳遞時(shí)間戳字符串方式傳遞簽名字符串方式傳遞業(yè)務(wù)參數(shù)車牌號(hào)字符串（）必填計(jì)費(fèi)時(shí)間日期時(shí)間必填格式：返回結(jié)果:成功示例""是否成功"":"失敗原因","":"京"車牌號(hào)應(yīng)收金額（扣除已收費(fèi)、減免后的金額）減免金額已收費(fèi)金額賬單標(biāo)識(shí)（若無則傳）:""入場(chǎng)時(shí)間:"”計(jì)費(fèi)

17、時(shí)間5.6.2 臨停支付完成通知接口類型:接口說明：通過平臺(tái)接入的線上支付完成后通知車場(chǎng)系統(tǒng)完成繳費(fèi)。接口地址:下行服務(wù)地址：廠商車場(chǎng)系統(tǒng)地址參數(shù)類型：字符串屬性名稱說明固定參數(shù)標(biāo)識(shí)字符串方式傳遞版本號(hào)字符串E專遞時(shí)間戳字符串E傳遞簽名字符串方式傳遞業(yè)務(wù)參數(shù)車牌號(hào):字符串（）:必填賬單標(biāo)識(shí)整型（）必填計(jì)費(fèi)接口返回的賬單標(biāo)識(shí)原樣返回計(jì)費(fèi)時(shí)間日期時(shí)間必填計(jì)費(fèi)接口返回的計(jì)費(fèi)時(shí)間原樣返回賬單編號(hào)字符串（）必填平臺(tái)支付賬單編號(hào)，用于平臺(tái)和本地對(duì)賬支付金額浮點(diǎn)數(shù)（）必填實(shí)際支付金額支付方式整型（）必填具體見說明優(yōu)惠金額浮點(diǎn)數(shù)（）返回結(jié)果”"":"""&qu

18、ot;:6數(shù)據(jù)字典定義6.1 車牌顏色標(biāo)識(shí)內(nèi)容藍(lán)色白色黑色黃色綠色6.2 支付方式標(biāo)識(shí)內(nèi)容現(xiàn)金支付支付寶支付微信支付銀聯(lián)支付6.3車輛類型標(biāo)識(shí)內(nèi)容小型車中型車大型車軍警車輛6.4收費(fèi)方式標(biāo)識(shí)內(nèi)容出口收費(fèi)中央收費(fèi)提前收費(fèi)（出入口擁堵時(shí)，使用手持機(jī)、等移動(dòng)設(shè)備提前收費(fèi)）繳費(fèi)（使用常州智慧停車微信公眾號(hào)或進(jìn)行線上支付）自助繳費(fèi)機(jī)7部分請(qǐng)求實(shí)例車場(chǎng)信息同步請(qǐng)求參數(shù)："",""："西土城路號(hào)","",""："宏福校區(qū)停車點(diǎn)",""："",""："前小時(shí)元，超過小時(shí)后每小時(shí)元。前分鐘免費(fèi)”調(diào)用方法：簽名字符串：簽名：請(qǐng)求：報(bào)文數(shù)據(jù)