停(ting)車場(chang)收費(fei)系(xi)統智慧(hui)屏(ping)應(ying)用(yong)
SDK 對(dui)接(jie)的車場(chang)使(shi)用(yong)智慧(hui)屏(ping),滿(man)足(zu)下(xia)列幾(ji)個(ge)前(qian)提(ti)條件,可實現(xian)斷(duan)網時(shi)的(de)進出(chu)場(chang)及支付(fu)。
1、車(che)場(chang)登(deng)錄(lu)雲平(ping)臺,在(zai)設備(bei)管理中(zhong)添(tian)加本(ben)地(di)使用(yong)的(de)通(tong)道(dao)(如果(guo)已有(you)使用(yong)中(zhong)的通(tong)道(dao),可調用(yong)接(jie)口(kou)2.14上傳(chuan)本地(di)的通(tong)道(dao)至雲端(duan))
2、車(che)場(chang)賬(zhang)號登錄(lu)小(xiao)程(cheng)序(xu)“車場(chang)雲管(guan)家(jia)”,在(zai)“車場(chang)信息”中(zhong)給(gei)指定(ding)通(tong)道(dao)添(tian)加智慧(hui)屏(ping),建(jian)立(li)屏(ping)與(yu)通(tong)道(dao)的連(lian)接(jie)
3、車場軟(ruan)件(jian)更換(huan)SDK 的 3.2.0.0 及以上版(ban)本,與(yu)智慧(hui)屏(ping)在(zai)同(tong)壹(yi)個(ge)局(ju)域網中(zhong),獲取指定(ding)通(tong)道(dao)的智慧(hui)屏(ping) ip(接(jie)口(kou) 7.1),並(bing)初(chu)始(shi)化連(lian)接(jie)智慧(hui)屏(ping)(接(jie)口(kou) 7.2),之(zhi)後可推送(song)出(chu)場訂(ding)單(dan)(接(jie)口(kou) 7.3)、獲(huo)取掃(sao)碼(ma)槍數據(ju)(接(jie)口(kou) 7.4)等操(cao)作(zuo)
獲(huo)取智慧(hui)屏(ping) ip(收費(fei)系(xi)統調用(yong)SDK)
應(ying)用(yong)場(chang)景(jing):
車(che)場(chang)登錄“雲車(che)場(chang)管(guan)家(jia)”小(xiao)程(cheng)序(xu)給(gei)指定(ding)通(tong)道(dao)綁定(ding)了智慧(hui)屏(ping)之(zhi)後,可調用(yong)該(gai)接(jie)口(kou)獲(huo)取智慧(hui)屏(ping)的(de) ip 地(di)址
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | screen_info | 是(shi) |
| data_target | 上傳(chuan)位(wei)置 | String | cloud | 是(shi) |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
示(shi)例:
{"service_name": "screen_info","data_target":"cloud","channel_id": "A11"}
同(tong)步(bu)返(fan)回(hui):
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | screen_info | 是(shi) |
| state | 初始(shi)化狀(zhuang)態(tai),0 失敗(bai) 1 成(cheng)功 | Number | 1 | 是(shi) |
| errmsg | 返(fan)回(hui)描述 | String | 查詢成(cheng)功 | 是(shi) |
| device_ip | 智慧(hui)屏(ping) ip | String | 192.168.199.199 | 否(fou) |
| device_id | 智慧(hui)屏(ping)設(she)備(bei)號 | String | 9528166666999999 | 否(fou) |
| device_name | 智慧(hui)屏(ping)名稱(cheng) | String | 東(dong)門(men)出口(kou) | 否(fou) |
| park_id | 車(che)場(chang)編號 | String | 21000 | 是 |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
示(shi)例:
{"device_ip":"192.168.199.199","device_name":"東(dong)門(men)出口(kou)","device_id":"9528166666999999","service_name":"screen_info","park_id":"21000","errmsg":"獲(huo)取成(cheng)功","state":1,"channel_id":"A11"}
初(chu)始(shi)化連(lian)接(jie)智慧(hui)屏(ping)(收費(fei)系(xi)統調用(yong)SDK)
應(ying)用(yong)場(chang)景(jing):
車(che)場(chang)獲取到指定(ding)通(tong)道(dao)的智慧(hui)屏(ping)的(de) ip 地(di)址後(hou),調(tiao)用(yong)該(gai)接(jie)口(kou)與(yu)智慧(hui)屏(ping)建(jian)立(li)連(lian)接(jie)
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | init_screen | 是(shi) |
| data_target | 上傳(chuan)位(wei)置 | String | wisdom_screen | 是(shi) |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
| device_ip | 設(she)備(bei)IP | String | 192.168.199.199 | 是 |
示例:
{ "service_name": "init_screen","data_target": "wisdom_screen","device_ip": "192.168.199.199", "channel_id": "A11"}
初(chu)始(shi)化同(tong)步(bu)返(fan)回(hui):
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | init_screen | 是(shi) |
| state | 初始(shi)化狀(zhuang)態(tai),0 失敗(bai) 1 成(cheng)功 | Number | 1 | 是(shi) |
| errmsg | 返(fan)回(hui)描述 | String | success | 是 |
示例:
{"errmsg":"success","service_name":"init_screen","state":1}
推送(song)出(chu)場訂(ding)單(dan)(收費(fei)系(xi)統調用(yong)SDK)
應(ying)用(yong)場(chang)景(jing):
車(che)輛出(chu)場(chang),計(ji)費(fei)系(xi)統核算(suan)出(chu)價格後,調(tiao)用(yong)該(gai)接(jie)口(kou)推送(song)訂(ding)單(dan)詳情顯示到(dao)智慧(hui)屏(ping),車(che)主可掃(sao)描該(gai)信息裏的(de)支付(fu)二(er)維(wei)碼(ma)進行(xing)支付(fu)
註:如果(guo)長(chang)時(shi)間未收到(dao)支付(fu)成(cheng)功回(hui)調,建(jian)議車(che)場(chang)及時(shi)發送其他信息(比(bi)如(ru)完(wan)成(cheng)頁(ye) 10秒(miao)後(hou)會(hui)刷(shua)新回(hui)到主頁(ye)),避免(mian)該信(xin)息壹(yi)直顯示,被(bei)其他車主誤(wu)掃(sao)
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng),出(chu)場消息 | String | out | 是 |
| data_target | 上傳(chuan)位(wei)置 | String | wisdom_screen | 是(shi) |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
| type | 1:月(yue)卡(ka),2:無(wu)需(xu)繳費(fei),3:繳費(fei)成(cheng)功,4:待(dai)支付(fu)繳費(fei)金(jin)額(e)信(xin)息 | Number | 4 | 是 |
| car_number | 車(che)牌(pai)號 | String | 京ABC9991 | 是 |
| total | 總金(jin)額(e) | String | 2.15 | 否(fou) ( type=3,4時(shi) 必(bi)傳(chuan) ) |
| out_pic | 出場(chang)圖片的base64 編(bian)碼(ma)格式, | String | data:image/jpg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4RnnRXhpZ... | 否(fou) |
| in_pic | 進(jin)場(chang)圖片的 base64 編(bian)碼(ma)格式 ,前(qian)綴(zhui)“data:image/jpg;base64,” | String | data:image/jpg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4RnnRXhpZ... | 否(fou) |
| price | 需(xu)要(yao)繳費(fei)的(de)金(jin)額(e) | String | 0.01 | 否(fou)( type=4 必(bi)傳(chuan) ) |
| reduce_amount | 減免(mian)金(jin)額(e) ,需(xu)帶單(dan)位(wei)“元” | String | 4.56元(yuan) | 否(fou)( type=4 必(bi)傳(chuan) ) |
| in_time | 入場(chang)時(shi)間 'yyyy-MM-dd HH:mm:ss' | String | 2020-10-16 08:08:08 | 否(fou) |
| duration | 停(ting)車時(shi)長(chang),單(dan)位(wei)分(fen)鐘(zhong) | String | 22 | 否(fou)( type=4 必(bi)傳(chuan) ) |
| code | 出口(kou)支付(fu)碼(ma)地(di)址,按(an)接(jie)口(kou) 7.5 生(sheng)成(cheng) | String | http://s.bolink.club/unionapi/thirdtopayorder?params=[1602751210742%2C0.01%2C臨BF4E338%2C20.15%2C1602815671%2C200160%2C21782%2CA11%2C1602815671]&sign=d2cdd57437f520735fe27c0ef50a0199 | 否(fou)( type=4 必(bi)傳(chuan) ) |
| prepay | 已預(yu)付(fu)金(jin)額(e) | String | 0.01 | 否(fou)( type=4 必(bi)傳(chuan) ) |
| state | 結(jie)果狀態,1 成(cheng)功,0 失敗(bai) | Number | 1 | 是 |
| tts | 語(yu)音播報(bao)內容 | string | 64 | 否(fou) |
示(shi)例:
{"service_name":"out","data_target":"wisdom_screen","type":4,"car_number":"京ABC9991","channel_id":"A11","total":"2.15","price":"0.01","reduce_amount":"4.56元","in_time":"2020-10-16 08:08:08","duration":"22","code":"http://s.bolink.club/unionapi/thirdtopayorder?params=[1602751210742%2C0.01%2C臨(lin)BF4E338%2C20.15%2C1602815671%2C200160%2C21782%2CA11%2C1602815671]&sign=d2cdd57437f520735fe27c0ef50a0199 ","prepay":"0.01","state":1,"tts":"京ABC123,請繳費(fei)2.15元(yuan)"}
初(chu)始(shi)化同(tong)步(bu)返(fan)回(hui):
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | out | 是(shi) |
| state | 初始(shi)化狀(zhuang)態(tai),0 失敗(bai) 1 成(cheng)功 | Number | 1 | 是(shi) |
| errmsg | 返(fan)回(hui)描述 | String | success | 是 |
接(jie)收被(bei)掃(sao)數據(ju)(SDK回(hui)調收費(fei)系(xi)統)
應用(yong)場(chang)景(jing):
車(che)場(chang)推送(song)出(chu)場訂(ding)單(dan)到(dao)智慧(hui)屏(ping)後(hou)
1、車(che)主可出示(shi)付(fu)款碼(ma)被(bei)掃(sao),車場接(jie)收該(gai)支付(fu)碼(ma)再調(tiao)用(yong)接(jie)口(kou) 2.2 上傳(chuan) pay_type=auth_code發起(qi)扣費(fei);
2、車(che)主支付(fu)完(wan)成(cheng)後,在(zai)斷網情況下(xia),車場(chang)無(wu)法收到(dao)接(jie)口(kou) 3.4 下(xia)發的支付(fu)成(cheng)功消(xiao)息,此時(shi)車(che)主可出示(shi)手(shou)機(ji)上的支付(fu)成(cheng)功二(er)維(wei)碼(ma)被(bei)掃(sao),車場收到(dao)該信(xin)息後可擡桿(gan)放(fang)行(xing)
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng),被(bei)掃(sao) | String | sweepcode | 是 |
| type | 被(bei)掃(sao)碼(ma)類(lei)型 | Number | 1 、手機(ji)付(fu)款碼(ma) ; 2 、支付(fu)成(cheng)功二(er)維(wei)碼(ma)被(bei)掃(sao) | 是 |
| pay_info | 支付(fu)成(cheng)功二(er)維(wei)碼(ma) | String | 否(fou)(type=2 時(shi)必(bi)傳(chuan)) | |
| authcode | 微信(xin)或支付(fu)寶(bao)的付(fu)款碼(ma) | String | 234567874567654 | 否(fou)(type=1 時(shi)必(bi)傳(chuan)) |
| channel_id | 通道(dao)號 | String | A11 | 是 |
示(shi)例:
{"service_name":"sweepcode","type":1,"channel_id":"A11","authcode":"234567874567654"}
初(chu)始(shi)化同(tong)步(bu)返(fan)回(hui):
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | sweepcode | 是(shi) |
| state | 初始(shi)化狀(zhuang)態(tai),0 失敗(bai) 1 成(cheng)功 | Number | 1 | 是(shi) |
| errmsg | 返(fan)回(hui)描述 | String | success | 是 |
示例:
{"errmsg":"success","service_name":"init_screen","state":1}
車(che)場(chang)生成(cheng)出口(kou)支付(fu)碼(ma)
應用(yong)場(chang)景(jing):
車(che)場(chang)調用(yong)接(jie)口(kou) 7.3 推送(song)出(chu)場訂(ding)單(dan)到(dao)智慧(hui)屏(ping),type 為(wei) 4 時(shi) 信(xin)息中(zhong)包(bao)含(han)該(gai)訂(ding)單(dan)的(de)支付(fu)信(xin)息鏈(lian)接(jie),調用(yong)該(gai)接(jie)口(kou)生(sheng)成(cheng)這個(ge)支付(fu)鏈(lian)接(jie),在(zai)智慧(hui)屏(ping)展(zhan)示為(wei)二(er)維(wei)碼(ma)形式,方便車主掃(sao)碼(ma)支付(fu)
註:
1、請求(qiu)地(di)址 https://s.bolink.club/unionapi/thirdtopayorder
2、sign簽(qian)名規則(ze)是(shi) params 的信(xin)息 直接(jie)拼接(jie)廠商(shang)秘鑰(yao) ukey 進行(xing)md5加密(mi)
3、params 有(you)序(xu) 數組(zu)格式,utf-8編(bian)碼(ma)後傳(chuan)入(獲(huo)取sign 簽(qian)名時(shi)無(wu)需(xu) utf-8 編(bian)碼(ma))
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| params | 有(you)序(xu)數組(zu)格式(utf-8編(bian)碼(ma)後傳(chuan)入) | String | [A1_2C1600858624,2.12,京A11111,0.1,1600863147,200279,21000,A1,1600863147] | 是 |
| sign | 簽(qian)名,32位(wei)小(xiao)寫 | String | a7cd3d7c8f30a3e32435aefc88650887 | 是 |
示(shi)例:
sign 獲(huo)取:
[A1_2C1627291675,2.12,京DTTT222,0.1,1627291740,200002,21840,A1,1627350591]EA2D90FEEF1E9F8E 進行(xing)MD5加密(mi)後(hou)取32位(wei)小(xiao)寫,得到(dao):542b570d75859a64e3642edfc4285334
params 參(can)數拼(pin)接(jie):A1_2C1627291675,2.12,京DTTT222,0.1,1627291740,200002,21840,A1,1627350591 進行(xing) utf-8 編碼(ma),得到(dao):
A1_2C1627291675%2C2.12%2C%E4%BA%ACDTTT222%2C0.1%2C1627291740%2C200002%2C21840%2CA1%2C1627350591
備註:params 參(can)數依次(ci)為(wei)
| 名稱(cheng) | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) | 示(shi)例 | 空(kong)值 |
|---|---|---|---|
| 訂(ding)單(dan)編(bian)號 | 是 | A1_2C1600858624 | 不可空(kong) |
| 價格 | 是,單(dan)位(wei) 元 ,最多兩(liang)位(wei)小(xiao)數 | 2.12 | 不可(0元直(zhi)接(jie)放(fang)行(xing)不需掃(sao)碼(ma)) |
| 車牌(pai)號 | 是 | 京A11111 | 不可空(kong) |
| 優惠(hui)金(jin)額(e) | 是(shi) | 0.01 | 0 |
| 入(ru)場時(shi)間 | 是(shi)(unix時(shi)間戳(chuo)格式到(dao)秒(miao)) | 1600863147 | 不可空(kong) |
| 廠商(shang)編號 | 是 | 200279 | 不可空(kong) |
| 車場(chang)編(bian)號 | 是 | 21000 | 不可空(kong) |
| 通道(dao)編號 | 是 | A1 | 不可空(kong) |
| 當(dang)前(qian)時(shi)間 | 是(shi)(unix時(shi)間戳(chuo)格式到(dao)秒(miao)) | 1600863147 | 不可空(kong), 1 分(fen)鐘(zhong)內有效(xiao),超時(shi)需(xu)重新生成(cheng) code |
推送(song)語(yu)音播報(bao)
應用(yong)場(chang)景(jing):
車(che)場(chang)向指定(ding)通(tong)道(dao)的智慧(hui)屏(ping)推送(song)語(yu)音播報(bao)
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | tts | 是(shi) |
| data_target | 上傳(chuan)位(wei)置 | String | wisdom_screen | 是(shi) |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
| content | 語(yu)音播報(bao)內容 | String | 請使用(yong)微(wei)信(xin)支付(fu)寶(bao)掃(sao)碼(ma)查詢 | 是 |
示例:
{ "service_name": "tts","data_target": "wisdom_screen","channel_id":"A11","content": "請使用(yong)微(wei)信(xin)支付(fu)寶(bao)掃(sao)碼(ma)查詢"}
推送(song)進(jin)場訂(ding)單(dan)
應(ying)用(yong)場(chang)景(jing):車(che)輛進(jin)場(chang),車(che)場(chang)調用(yong)該(gai)接(jie)口(kou)推送(song)車(che)輛詳情顯示到(dao)智慧(hui)屏(ping)。可在(zai)智慧(hui)屏(ping)入(ru)口(kou)顯示車(che)牌(pai)和(he)歡迎光臨等文字同(tong)時(shi)語(yu)音播報(bao)
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng),進(jin)場消息 | String | in | 是 |
| data_target | 上傳(chuan)位(wei)置 | String | wisdom_screen | 是(shi) |
| channel_id | 通(tong)道(dao)編號 | String | A11 | 是 |
| car_number | 車(che)牌(pai)號 | String | 京ABC9991 | 是 |
| in_time | 入(ru)場時(shi)間,'yyyy-MM-dd HH:mm:ss' | String | 2021/11/05 21:09:09 | 否(fou) |
| text | 文本顯示內容 | String | 您(nin)好(hao),歡迎光臨 | 否(fou) |
| tts | 語(yu)音播報(bao)內容 | String | 您(nin)好(hao),歡迎光臨 | 否(fou) |
示(shi)例:
{ "service_name": "in","data_target": "wisdom_screen","car_number": "京HJ9900","channel_id": "1890","in_time": "2021-11-05 08:08:08","tts": "您(nin)好(hao),歡迎光臨","text": "您(nin)好(hao),歡迎光臨"}
同(tong)步(bu)返(fan)回(hui):
字段(duan)信(xin)息:
| 名稱(cheng) | 說(shuo)明(ming) | 類(lei)型 | 示例 | 是(shi)否(fou)必(bi)傳(chuan)字段(duan) |
|---|---|---|---|---|
| service_name | 接(jie)口(kou)名稱(cheng) | String | in | 是(shi) |
| state | 初始(shi)化狀(zhuang)態(tai),0 失敗(bai) 1 成(cheng)功 | Number | 1 | 是(shi) |
| errmsg | 返(fan)回(hui)描述 | String | success | 是 |
- 上壹(yi)篇(pian):倍(bei)加(jia)信(xin)停(ting)車場(chang)在(zai)線支付(fu),支持(chi)的(de)銀行(xing)清(qing)單(dan) 2022/12/13
- 下(xia)壹(yi)篇(pian):倍(bei)加(jia)信(xin)停(ting)車場(chang)系(xi)統寧夏交警(jing)數據(ju)上報(bao) 2022/12/12
