:-: **注意:停車系統與泊鏈平臺的對接方式**
停車收費系統與泊鏈平臺的對接方式有兩種,SDK對接和HTTP對接模式。采用SDK對接請跳過本小結。下面介紹通過HTTP模式對接泊鏈的具體方法:
與泊鏈對接涉及接口有:1.1, 2.1, 2.2, 2.3,3.1, 3.2, 3.3,3.4。對接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。
即對
{"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格式的字符串。接口字段中的時間參數為UTC格式是指從1970年1月1日零點起到當前時間的秒數,為長整數。
- 停車系統與車場SDK接口協議(含http模式)
- 修訂記錄
- SDK開發包下載
- 一、系統集成
- 1.1初始化
- 1.2反初始化
- 二、上行接口
- 2.1車輛入場
- 2.1.1更新用戶余額(http模式)
- 2.2車輛出場電子支付
- 2.3獲取二維碼地址
- 2.4 車場訂單電子支付狀態查詢接口
- 2.5 查詢在場訂單
- 2.6 車輛圖片上傳
- 三、下行接口
- 3.1查詢訂單價格
- 3.2預付訂單通知
- 3.3無牌車入場請求
- 3.4電子收費異步返回結果
- 四、查詢免密及電子支付(SDK提供)
- 4.1獲取當前車牌余額及是否支持免密及電子支付
- 五、附錄
- 5.1 數據定義
- 5.1.1訂單支付類型:pay_type
- 5.1.2是否是泊漣會員:is_exist
- 5.1.3網絡狀態:net_status
- 5.1.4訂單支付通道:pay_channel
- 六、常見問題答疑
- 七、專題文檔