:-: **注意:停车系统与泊链平台的对接方式**
停车收费系统与泊链平台的对接方式有两种,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
- 六、常见问题答疑
- 七、专题文档