联系方式

    商务咨询热线

    姓名:姜先生

    电话:137 9849 8030

    邮件:36961055@qq.com

    网站:http://www.beijiaxin.net

你的位置:首页 > 新闻动态 > 技术文章

停车收费系统对接协议(车场管理+支付)

时间:2022/3/16 10:36:35      点击:

注意:停车系统与泊链平台的对接方式

停车收费系统与泊链平台的对接方式有两种,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初始化后获取的令牌String6fadf87a5bae43b68a6ae6fc6912f61f

返回状态说明:

名称说明类型示例是否必传字段
state状态,1成功,0无消息,-1已离线,需要重新初始化Number1
data数据Json{}
errmsg提示信息String

停车收费系统与SDK之间的调用,数据传入和返回都采为json格式,收费系统调用SDK时,java版本提供一个类名为UploadUtil的对象,提供了一些静态方法,包含了初始化和上行接口的所有方法,每个方法中只有一个参数,为json格式的字符串。接口字段中的时间参数为unix时间戳格式是指从1970年1月1日零点起到当前时间的秒数,为长整数。

接口名称后括号中标明的停车云、泊链 是指收费系统调用接口后,sdk处理后发送数据的方向,如车辆出入场数据,要同时向停车云和泊链传输。电子收费业务需要与泊链进行数据交互才可以完成。


Copyright 2004~2024 www.beijiaxin.net 深圳市倍加信科技有限公司 版权所有 All Rights Reserved 工信部备案号:粤ICP备19068560号