:-: **注意:停車系統與泊鏈平臺的對接方式**
停車收費系統與泊鏈平臺的對接方式有兩種,SDK對接和HTTP對接模式。采用SDK對接請跳過本小結。下面介紹通過HTTP模式對接泊鏈的具體方法:
與泊鏈對接涉及接口有:1.1,1.3, 2.1,2.2,2.18,3.1,3.2,3.3,3.4,**3.12**、4.2.對接HTTP模式時,上述接口將不再通過調用SDK的UploadUtil方法上傳數據,而是采用發送HTTP請求的方式將上行的JSON串包,**在http請求header中"Content-Type"設置為"application/json;charset=utf-8",JSON串數據放置在body中,發送POST請求到泊鏈服務器。**
組織上行數據時, 根據接口文檔要求組織的SDK參數, 設為data, 例如初始化, data為:
{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}
然后進行簽名, 簽名方式為 data數據串+ key=8403A41ED5EF20BC 然后對整串進行md5加密, 得到sign。(注:key是對應廠商的key,此處key僅為示例)
即對
{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}key=8403A41ED5EF20BC 進行md5加密。然后將service_name, sign, token, data組成最終的上行JSON格式數據, 例
{"service_name":"login","sign":"CB649425CB5548A375099103AB04CC1E","data":{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}}
登錄時沒有token, 故不用添加, 其他接口中, token為必傳字段
上行數據的HTTP請求地址:
http://ptest.bolink.club/bpd/upload.do (測試平臺)
http://p.bolink.club/bpd/upload.do (正式平臺)
獲取泊鏈下發的下行數據需采用http輪詢的方式,當泊鏈服務器有需要推送給車場的消息時,會獲取JSON格式的下行消息。上行和下行的消息格式與上述SDK接口文檔中定義的一致。輪詢規則:車場發一個http長輪詢請求到泊鏈,泊鏈會暫時不返回這個請求,等待30秒后返回無消息,如30秒內有消息會及時返回,車場收到http的返回后應及時再次發起一次請求,確保**有且僅有一個http長輪詢請求存在,如果發生斷開要車場端主動發起新的連接**。
下行數據的HTTP請求地址:
http://ptest.bolink.club/bpd/download.do (測試平臺)
http://p.bolink.club/bpd/download.do (正式平臺)
下行接口的請求參數(POST):
| 名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
token| 初始化后獲取的令牌 |String|6fadf87a5bae43b68a6ae6fc6912f61f |是
返回狀態說明:
| 名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
state| 狀態,1成功,0無消息,-1已離線,需要重新初始化 |Number |1 |是
data| 數據 |Json |{} |是
errmsg| 提示信息 |String ||否
**停車收費系統與SDK之間的調用,數據傳入和返回都采為json格式,收費系統調用SDK時,java版本提供一個類名為UploadUtil的對象,提供了一些靜態方法,包含了初始化和上行接口的所有方法,每個方法中只有一個參數,為json格式的字符串。接口字段中的時間參數為unix時間戳格式是指從1970年1月1日零點起到當前時間的秒數,為長整數。**
**接口名稱后括號中標明的停車云、泊鏈 是指收費系統調用接口后,sdk處理后發送數據的方向,如車輛出入場數據,要同時向停車云和泊鏈傳輸。電子收費業務需要與泊鏈進行數據交互才可以完成。**
- 停車收費系統對接協議(車場管理+支付)
- 修訂記錄
- SDK開發包下載
- 一、系統集成
- 1.1初始化(廢棄版本)
- 1.2 車場初始化(SDK 4.2 及后續版本)
- 1.2.1 加密說明
- 1.3反初始化
- 1.4 http退出登錄接口
- 二、上行接口(收費系統調用 SDK)
- 2.1 車輛入場(停車云,泊鏈)
- 2.2車輛出場(泊鏈,停車云)
- 2.3異常訂單記錄上傳(停車云)
- 2.4車場收費員信息上傳(停車云)
- 2.5員工上下班記錄上傳(停車云)
- 2.6日志上傳(停車云)
- 2.8月卡套餐上傳(停車云)
- 2.9價格上傳(停車云)
- 2.10月卡會員上傳(停車云)
- 2.11異常抬桿/落桿上傳(停車云)
- 2.12車輛圖片上傳
- 2.13月卡續費記錄上傳(停車云)
- 2.14通道數據上傳 (停車云)
- 2.15黑名單上傳(停車云)
- 2.16車型數據上傳(停車云)
- 2.17出場模糊匹配確認事件上傳(停車云)
- 2.18獲取二維碼地址(泊鏈)
- 2.19車場訂單電子支付狀態查詢接口
- 2.20 查詢在場訂單(泊鏈)
- 2.21崗亭交易訂單查詢(泊鏈返回h5 url)
- 2.22 崗亭交接班記錄(泊鏈)
- 2.23 云平臺對賬接口(停車云)
- 2.24 月卡信息查詢(停車云)
- 2.25 儲值卡上傳(停車云)
- 2.26 儲值卡充值記錄上傳(停車云)
- 2.27 儲值卡扣除余額上傳(停車云)
- 2.28 儲值卡余額查詢(停車云)
- 2.29 上傳優惠券減免接口(停車云)
- 2.30 泊鏈電子支付對賬接口
- 2.31電子發票上傳接口
- 2.32 上傳收費系統日志
- 2.33 分頁查詢月卡信息(停車云)
- 2.34 充電減免信息上傳(停車云)
- 2.35 內部車上傳(停車云)
- 2.36 平臺轉發接口(停車云)
- 2.37 ETC扣費
- 2.38 逃單查詢
- 2.39停車場停車業務糾正
- 2.40在停業務總數查詢
- 2.41在停業務詳情查詢
- 2.42市級車入場判定
- 2.43獲取車道屏幕文字
- 2.44離線訂單(先走后付)
- 三、下行接口(SDK回調收費系統)
- 3.1查詢訂單價格(泊鏈)
- 3.2預付訂單通知(泊鏈)
- 3.3無牌車入場請求(泊鏈)
- 3.4電子收費異步返回結果(泊鏈)
- 3.5價格同步(停車云)
- 3.6月卡套餐同步(停車云)
- 3.7月卡會員同步(停車云)
- 3.8車場收費員信息同步(停車云)
- 3.9接收消息實現鎖車/解鎖(停車云)
- 3.10月卡續費(泊鏈)
- 3.11 公眾號月卡續費查詢價格(停車云)
- 3.12優惠券信息同步(停車云)
- 3.13通道數據下發 (停車云)
- 3.14黑名單下發(停車云)
- 3.15車型數據下發(停車云)
- 3.16月卡續費記錄下發(停車云)
- 3.17手動匹配訂單通知(停車云)
- 3.18 抬桿/落桿通知(停車云)
- 3.19 訪客管理下發 (停車云)
- 3.20 儲值卡同步(停車云)
- 3.21 儲值卡余額變更記錄下發(停車云)
- 3.22 云平臺透傳接口
- 3.23 退款下發通知(泊鏈)
- 3.24 找零支出下發通知(泊鏈)
- 3.25 平臺繳費通知(停車云)
- 3.26 查詢車場停車位通知(停車云)
- 3.27 內部車同步(停車云)
- 3.28 手動結算(停車云)
- 3.29 追繳訂單異步返回結果(泊鏈)
- 3.30 積分電子券信息同步(泊鏈)
- 3.31 車道監控抓拍下發(停車云)
- 3.32 通知上傳收費系統日志(泊鏈)
- 3.33 下發收費系統升級通知(泊鏈)
- 3.34 公眾號新建月卡查詢價格(停車云)
- 3.35 車場有效期下發(停車云)
- 3.36 充電樁充電通知(泊鏈)
- 3.37 逃單補繳異步返回結果(泊鏈)
- 3.38 車輛包月賬單信息查詢
- 3.39 修改道閘余位
- 3.40 查詢月卡車、特殊車
- 3.41 門禁讀取的健康碼狀態下發(停車云)
- 3.42 補錄訂單手動入場
- 3.43 在場訂單車牌校正
- 3.44 無在場訂單固定收費
- 四、查詢免密及電子支付(SDK提供)
- 4.1獲取車牌是否支持免密和SDK心跳
- 4.2推送當前車牌余額及是否支持無感支付(http)
- 五、常見問題與數據定義
- 5.1 數據定義
- 5.1.1車型:car_type
- 5.1.2 入場/出場車型:c_type/out_type
- 5.1.3 訂單支付類型:pay_type
- 5.1.4鎖車標記:islocked
- 5.1.5性別:sex
- 5.1.6操作類型:operate_type
- 5.1.7員工上下班類型:state
- 5.1.8數據上傳位置:data_target
- 5.1.9異常抬桿原因:reason
- 5.1.10是否是泊漣會員:is_exist
- 5.1.11網絡狀態:net_status
- 5.1.12訂單支付通道:pay_channel
- 5.2 常見問題答疑
- 六、專題文檔
- 七、智慧屏應用
- 7.1 獲取智慧屏 ip(收費系統調用SDK)
- 7.2 初始化連接智慧屏(收費系統調用SDK)
- 7.3 推送出場訂單(收費系統調用SDK)
- 7.4 接收被掃數據(SDK回調收費系統)
- 7.5 車場生成出口支付碼
- 7.6 推送語音播報
- 7.7 推送進場訂單