宜泊科技
  1. 宜泊科技标准接口文档v3.0
宜泊科技
  • 宜泊科技标准接口文档v3.0
    • 3.1-接口规范
    • 3.2-合作商调用接口
      • 3.2.1-临停缴费
        • 订单同步paysyncWithDeductionV3
        • 查费getProStopWithDeductionV3
        • 无牌车入场
      • 3.2.2-CRM系统优惠接入
        • CRM查费V5
        • CRM订单同步V5
      • 3.2.3-抵扣券业务
        • 分钟抵扣券发放
        • 分钟抵扣券删除
        • 小时/金额抵扣券发放(同时支持5.0车场)
        • 查询抵扣券列表
        • 查询抵扣券详情
      • 3.2.4-月租/固定车同步
        • 3.2.4.1-使用宜泊系统进行月租管理
          • 月租费率按车场查询
          • 月租新增
          • 月租删除
          • 月租车获取充值费用
          • 月租车充值结果下发
          • 月租修改
          • 查询车场所有月租
          • 月租查询
        • 3.2.4.2-使用第三方物业系统进行月租管理
          • 月租同步
      • 3.2.5-道闸接口
        • 控制道闸开闸
        • 控制道闸落闸
        • 场内车出场状态更新(删除在场车)
        • 道闸常开
      • 3.2.6-共享停车6.0
        • 共享车预约下单同步
        • 共享车预约终止
        • 共享预约车查询用户数据
        • 预约同步接口V2-支持出入权限管理
      • 3.2.7-剩余车位查询
        • 剩余车位查询
      • 3.2.8-时段月租同步业务
        • 获取时段月租费率
        • 新增&更新时段月租车辆信息
        • 删除时段月租车辆信息
        • 根据车牌获取内部车信息
      • 3.2.9-电子发票平台接口
        • 电子发票查询
      • 3.2.10-锁车业务
        • 下发解锁车辆命令
        • 下发锁定车辆命令
      • 3.2.11-白名单同步接口
        • 删除白名单车
        • 添加白名单车
      • 3.2.12-新增酒店车
        • 新增酒店车
        • 查询酒店车
        • 删除酒店车
      • 3.2.13特殊车辆操作
        • 同步特殊车辆接口
        • 查询特殊车辆接口
        • 删除特殊车辆接口
      • 3.2.14查询在场车全量数据
    • 3.3-上报合作商接口
      • 3.3.1-停车场信息出入场上报
        • 车辆入场上报
        • 车辆出场上报
        • 车场订单上报
        • 第三方无感出场
        • 停车场基础信息上报
        • 异常抬杆数据上报
        • 设备状态上报
    • 3.4-CPGS
      • ⼀次性查询停车场内车位占⽤状态
      • 模糊查询车牌
      • 根据车牌获取车辆位置信息
      • 车库剩余车位数查询
  1. 宜泊科技标准接口文档v3.0

3.1-接口规范

基础说明#

所有请求数据格式采用UTF-8编码
所有请求采用HttpPOST协议(content-type=“application/json”)
返回数据根据具体的接口返回UTF-8编码(gzip压缩)
数据格式采用JSON形式
根据MD5签名来验证请求数据合法性与完整性
请求返回采用同步方式

安全认证说明#

接口都采用对POST数据签名的方式来认证合法性。
签名方式采用MD5,签名源字符串为POST数据,key(由宜泊提供固定字符串)拼接字符串。
📌
示例:
查询停车费用接口:http://testlpn.ebopark.com/partnerService/getProStopWithDeductionV3
POST数据为:
{"parkCode": "140123001","carNo": "川BFFF01","channelNo": "1864", "openId": "testsu13250315780","extre": "备注信息","deductionId": "[]"}
签名Key为:206d98f4de9e4423b3aa42cd0c36fd84
拼接后的字符:
{"parkCode": "140123001","carNo": "川BFFF01","channelNo": "1864", "openId": "testsu13250315780","extre": "备注信息","deductionId": "[]"}206d98f4de9e4423b3aa42cd0c36fd84
做MD5(32位)计算后:e6e2e281a7f48c031110172ade54375a
接口字段顺序不在校验范围内,不需要对数据进行顺序排列。

注:若遇到签名错误:#

请检查请求参数与参与加密的参数是否完全格式一致

请求地址:#

所有宜泊平台接口url参数都必须传入partnerid,sign
上报合作商数据协议[接收数据由合作商实现],无需partnerid,只需sign
测试授权合作商ID(partnerid):test
测试秘钥(签名Key):206d98f4de9e4423b3aa42cd0c36fd84
测试停车场编号(ParkCode):
6.0车场版本编码:140123001;
5.0车场版本编码:5108234。
如失败请与研发确认
测试环境酒店商户
merchantid:713
parkcode:140123001

请求地址#

测试环境地址:http://testlpn.ebopark.com
正式环境地址:http://lpn.ebopark.com

请求示例#

http://testlpn.ebopark.com/partnerService//partnerService/getProStopWithDeductionV3?partnerid=test&sign=b31622efc797dd8a6d7d27fe6d68d822

模拟车牌入场、缴费、出场:#

http://pz.ebopark.com:10000/app/test-copy/page-674eadad49a50f71fdb81603
选择入场时间、出场时间、填入车牌后,点击入场,即可

MD5示例代码--java#

private static String MD5(String sourceStr,int type) {
String result = "";
try {
MessageDigest md = MessageDigest.getInstance("MD5");
md.update(sourceStr.getBytes("UTF-8"));
byte b[] = md.digest();
int i;
StringBuffer buf = new StringBuffer("");
for (int offset = 0; offset < b.length; offset++) {
i = b[offset];
if (i < 0)
i += 256;
if (i < 16)
buf.append("0");
buf.append(Integer.toHexString(i));
}
if(type == 32) {
result = buf.toString();
}else if(type == 16){
result = buf.toString().substring(8, 24);
}
//Common.println("MD5:"+result);
} catch (NoSuchAlgorithmException | UnsupportedEncodingException e) {
e.printStackTrace();
}
return result;
}
public static String md5EncryptTo32(String sourceStr){
return MD5(sourceStr,32).toLowerCase();
}
- 错误编码
** 响应代码 信息**
-1001001 系统错误
-1001003 参数不完整
-1001007 签名不正确
-1102001 合作商信息错误(确保partnerid正确)
-1103003 车场不支持电子支付
-1101602 支付停车费用失败(需要退费)
-1101603 查询停车费用失败
-1108005 查询超时
-1104001 车辆未入场
-1120001 已存在有效的临停车通道授权信息(需要取消之前的授权信息)
-1120002 不存在此临停车通道授权信息
-1199002 无入场信息
-1001002 数据修改失败
上一页
宜泊科技标准接口文档v3.0
下一页
订单同步paysyncWithDeductionV3
Built with