> ## SDK 4.2 及后續版本支持車場軟件**上行接口**加密傳輸;
> ## 初始化及下行接口無需加密
*****
## **1、車場調用 http 請求到云平臺獲取公鑰**
> 如果本地軟件未升級、不支持加密傳輸,可忽略該操作,直接初始化即可正常使用
請求地址::http://yun.bolink.club/zld/sdkSecurity/getPublicKey
調用方式:POST
請求參數:
| 字段名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
union_id |廠商編號| Number |200002 |是
park_id |車場編號| String| 21787 |是
同步返回內容:
| 字段名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
state |狀態 |Number |0失敗1成功 |是
msg|方法返回描述 | String| 獲取成功 | 是 |
public_key|車場公鑰 |String| MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCSz+Uw1Z0EYzDekusCk+FzhOd9gvuy/+LG9e/mn7bDkztYa2abs4N6dE6XzZjsa6T/nNF4VC865/8RqO+BSB2F7wNbG0QzVmcVpk51kYCoiZzsgdUJ+HGLyadAyWcMOb6zRQqxXeu7M10nizkQbXfLIPZN02QEIzCJXMQuew |是
> 注:
> 車場獲取到公鑰后,明文初始化,云端返給SDK 私鑰保存;本地軟件用公鑰加密上行消息上傳給SDK(文檔1.2.1),SDK用私鑰解密后上傳到云平臺;每個車場的公鑰和私鑰這對組合是固定的
*****
## **2、車場初始化**
> 車場SDK與停車收費系統集成時,收費系統調用SDK提供的初始化方法,初始化一些身份信息。
> Java版本的調用方法名為UploadUtil.init(String jsonData),調用時,把所有參數按json對象格式組成字符串,作為參數給java方法。
字段信息:
| 名稱 | 說明 | 類型 |最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
| union_id | 廠商平臺賬號 | String|15 | 200002 | 是 |
| ukey | 廠商平臺密鑰 | String|24 | EA2D90FEEF1E9F8E | 是 |
| park_id | 車場編號 | String|24 | 3251 | 是 |
| cloud_addr | 停車云域名 | String|18 | 測試環境:ts.bolink.club;正式環境:1029.parkingos.club | 是 |
|cport | 停車云端口 | Number |10 | 測試環境:6791;正式環境6789 | 是 |
| local_id | 收費系統編號,同一車場的收費系統編號不可重復,車場存在多個收費系統集成sdk時,必傳,車場sdk初始化參數中的local_id,可以按規則包含通道信息,用關鍵字channels后加下劃線加通道號(通道號可由數字、字母、中文組成),多個時用下劃線分隔,結尾不要加下劃線,如local_id=mac001,需要綁定A1、A2、A3三個通道,那就寫為local_id=aaa001_channels_A1_A2_A3,那么這個sdk就管理了三個通道:A1,A2,A3。在泊鏈后臺生成入場或出場二維碼,輸入的通道號在這個sdk管理中,車主掃帶該通道號二維碼時,泊鏈會把入場或出場消息發給這個sdk(在線),如果sdk不在線,則不發送。 | String|196 | 22AA | 否 |
log_show| sdk是否打印日志| number| 2|0不打印日志,1打印,默認0| 否
set_params| 設置參數,擴展參數,見下表說明| json|48 |{"prepay_send":"1"} |否
擴展參數
| 名稱 | 說明 | 類型|最大長度| 示例 | 是否必傳 |
| --- | --- | --- | --- | --- | --- |
| prepay_send |接收預付消息,0不收,1接收 | String |2 | 1 | 否 |
| month_send |接收公眾號月卡續費消息,0不收,1接收 | String|2 | 1 | 否 |
|receive_cloud|接收云平臺下行消息,0不收,默認1接收|string|2|1|否
| prepay_query | 是否接收預付查詢,0不接收預付查詢 ,其他設置不生效 | number | 2 | 0 | 否
| fast | 是否同步返回,設置true后上行接口除了2.1和2.2之外都是同步返回,不再異步,默認是false | bool | | true | 否
|autoconnect | 斷網是否重連,默認1自動重連。 0代表不自動,1代表自動;4.2及以后版本有效| number | | 1 | 否
> jsonData數據示例
> {"union_id":"200002","ukey":"EA2D90FEEF1E9F8E","park_id":"3251","cloud_addr":"ts.bolink.club","cport":6791,local_id”:"aaa001_channels_A1_A2_A3","set_params":{"prepay_send":"1","month_send":"1","receive_cloud":"1"}}
* * * * *
車場初始化同步返回:
| 名稱 | 說明 | 類型| 最大長度|示例 | 是否必傳 |
| --- | --- | --- | --- | --- | --- |
| state | 狀態 | Number | 2|0失敗1成功 | 是 |
| errmsg | 方法返回描述 | String|48 | Init success! | 是 |
示例:{"state":1,"errmsg":"Init success! "}
*****
- 停車收費系統對接協議(車場管理+支付)
- 修訂記錄
- 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 推送進場訂單