:-: **注意:停车系统与泊链平台的对接方式**
停车收费系统与泊链平台的对接方式有两种,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| 初始化后获取的令牌 |String|6fadf87a5bae43b68a6ae6fc6912f61f |是
返回状态说明:
| 名称 | 说明 | 类型 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- |
state| 状态,1成功,0无消息,-1已离线,需要重新初始化 |Number |1 |是
data| 数据 |Json |{} |是
errmsg| 提示信息 |String ||否
**停车收费系统与SDK之间的调用,数据传入和返回都采为json格式,收费系统调用SDK时,java版本提供一个类名为UploadUtil的对象,提供了一些静态方法,包含了初始化和上行接口的所有方法,每个方法中只有一个参数,为json格式的字符串。接口字段中的时间参数为unix时间戳格式是指从1970年1月1日零点起到当前时间的秒数,为长整数。**
**接口名称后括号中标明的停车云、泊链 是指收费系统调用接口后,sdk处理后发送数据的方向,如车辆出入场数据,要同时向停车云和泊链传输。电子收费业务需要与泊链进行数据交互才可以完成。**
- 停车收费系统对接协议(车场管理+支付)
- 修订记录
- 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 推送进场订单