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

选择入场时间、出场时间、填入车牌后，点击入场，即可

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 数据修改失败

基础说明#

安全认证说明#

注：若遇到签名错误：#

请求地址：#

请求地址#

请求示例#

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

MD5示例代码--java#

基础说明

安全认证说明

注：若遇到签名错误：

请求地址：

请求地址

请求示例

模拟车牌入场、缴费、出场：

MD5示例代码--java