北京停简单信息技术有限公司

停简单-车位出租接口文档

约定

接口如无特殊说明，遵照以下规范。

1. 时间格式约定 "yyyy-MM-dd HH:mm:ss"、"yyyy-MM-dd"、"HH:mm:ss"
2. 金额格式统一为:(最大9位).(最多2位)。需要通过此正则表达式^((([1-9]{1}\d{0,9}))|([0]{1}))((\.(\d){2}))?$。

开放平台

开放平台接入规范

签名生成的通用步骤如下:

设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。 特别注意以下重要规则:
* 参数名ASCII码从小到大排序（字典序）；
* 参数名区分大小写；
* sign和signType和空值参数不参与签名
* 传递参数的值中如果存在特殊字符（如:&、@等），那么该值需要做URL Encoding，这样请求接收方才能接收到正确的参数。此时，待签名数据应该是原始值而不是encoding之后的值。 举例:

例:假设传送的参数如下: appid: tjd930ea5d5a258f4f charset:utf-8 service:tcwindows.Park.getParkInfo timestamp:2016-04-01 12:11:11 version:1.0
1. 对参数按照key=value的格式，并按照参数名ASCII字典序排序如下: stringA="appid=tjd930ea5d5a258f4f&charset=utf-8&service=tcwindows.Park.getParkInfo=1000×tamp=2016-04-01 12:11:11&version=1.0&.............";
2. 拼接API密钥: stringSignTemp="stringA192006250b4c09247ec02edce69f6a2d"
3. md5签名得到最终sign sign=MD5(stringSignTemp)="9A0A8659F005D6984697E2CA0A9CF3B7"

开放平台接入接口

1. 描述
2. URL
3. 请求参数列表

4. 响应参数列表

5. 请求样例

{
    "carInfoList": "[{carNum=京FFFHH2, gcCargroupandcarId=lsclze8b9e924374919f292f3a8ff004}, {carNum=京FFFHH2, gcCargroupandcarId=lsclze8b9e924374919f292f3a8ff004}]", 
    "charset": "utf-8", 
    "groupId": "3156514a7f2e433eb3f6cb3da0a18b7f", 
    "partner": "1c0984d344244fc2a4d2127875df4e25", 
    "service": "groups.gcOut.updateCarGroupCarBatch", 
    "sign": "8d0654b1e634e5a1ba77c3553f3e445e", 
    "signType": "md5", 
    "timestamp": "2016-05-07 12:01:09", 
    "version": "1.0"
}

车位出租用户信息管理

创建购买用户信息接口

• 描述：
• •method：mgr.rentOut.createUserInfo,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "用户创建成功", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "pmSetrentUserinfoId": "431102199204108364"
}

修改购买用户信息接口

• 描述：
• •method：mgr.rentOut.updateUserInfo,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "用户修改成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

删除购买用户信息接口

• 描述：
• •method：mgr.rentOut.deleteUser,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "用户删除成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

查询购买用户信息接口

• 描述：
• •method：mgr.rentOut.queryUserInfo,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "totalCount": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "userInfoList": [
        {
            "pmSetrentUserinfoId": "431102199204108364", 
            "name": "用户1", 
            "phone": "14700000000", 
            "address": "北京" , 
            "idcard": "用户1", 
            "driveLicence": "132000000333300", 
            "content": "北京",
            "code": "001",
            "department": "部门01" 
        }
        ....
    ]
}

查询停车场购买用户信息接口

• 描述：
• •method：mgr.rentOut.selectUserInfoByMap,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "totalCount": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "userInfoList": [
        {
            "pmSetrentUserinfoId": "431102199204108364", 
            "name": "用户1", 
            "phone": "14700000000", 
            "address": "北京" , 
            "idcard": "用户1", 
            "driveLicence": "132000000333300", 
            "content": "北京",
            "code": "001",
            "department": "部门01" 
        }
        ....
    ]
}

车位出租车辆信息管理

添加购买用户的车辆信息接口

• 描述：
• •method：mgr.rentOut.addCarInfo,请求方式：post
• 请求参数列表

* 响应参数列表

* 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "车辆添加成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"，
    "pmSetrentCarinfoId": "431102199204108364"
}

修改购买用户的车辆信息接口

• 描述：
• •method：mgr.rentOut.updateCarInfo,请求方式：post
• 请求参数列表

* 响应参数列表

* 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "车辆更新成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

删除购买用户的车辆信息接口

• 描述：
• •method：mgr.rentOut.deleteCarInfo,请求方式：post
• 请求参数列表

* 响应参数列表

* 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "车辆删除成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

查询购买用户的车辆信息接口

• 描述：
• •method：mgr.rentOut.queryCarInfo,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "totalCount": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "carList": [
       {
            "pmSetrentUserinfoId": "431102199204108364", 
            "pmSetrentCarinfoId": "431102199204108360", 
            "carNum": "京A12345", 
            "carNumColor": "blue" 
        }
        ...
    ]
}

车位出租订单和卡信息管理

首次购买车位下单接口

• 描述：
• •method：mgr.rentOut.firstTimeBuyAction,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "下单成功", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "omPrOrderRentOutVo": 
       {
            "omPrOrderId": "431102199204108364", 
            "omPrCardId": "431102199204108360", 
            "productName": "包月123", 
            "name":"用户1",
            "phone": "13011202310",
            "carNums": "京A12345",
            "userInfoId": "431102199204108302" , 
            "count": "1" ,
            "startDt": "1471881600000", 
            "endDt": "1471881600000", 
            "amount": "4.00", 
            "state": "03", 
            "createDt": "1471881600000",
            "paySucDt": "1471881600000", 
            "orderType": "0" 
        }
}

续费购买车位下单接口

• 描述：
• •method：mgr.rentOut.renewBuyAction,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "续费购买成功", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "omPrOrderRentOutVo": 
       {
            "omPrOrderId": "431102199204108364", 
            "omPrCardId": "431102199204108360", 
            "productName": "包月123", 
            "name":"用户1",
            "phone": "13011202310",
            "carNums": "京A12345",
            "userInfoId": "431102199204108302" , 
            "count": "1" ,
            "startDt": "1471881600000", 
            "endDt": "1471881600000", 
            "amount": "4.00", 
            "state": "03", 
            "createDt": "1471881600000",
            "paySucDt": "1471881600000", 
            "orderType": "1" 
        }
}

现金购买车位支付接口

• 描述：
• •method：mgr.rentOut.cashPay,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "购买支付成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

取消订单接口

• 描述：
• •method：mgr.rentOut.cancel,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "取消订单成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

查询订单信息列表接口

• 描述：
• •method：mgr.rentOut.queryOrderList,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "orderList": [
       {
            "omPrOrderId": "431102199204108364", 
            "omPrCardId": "431102199204108360", 
            "productName": "包月123", 
            "phone": "13011202310",
            "carNums": "京A12345",
            "userInfoId": "431102199204108302" , 
            "count": "1" ,
            "startDt": "1471881600000", 
            "endDt": "1471881600000", 
            "amount": "4.00", 
            "state": "03", 
            "createDt": "1471881600000",
            "paySucDt": "1471881600000", 
            "orderType": "0" 
        }
        ....
    ]
}

查询用户卡信息列表接口

• 描述：
• •method：mgr.rentOut.queryUserCardsList,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "totalCount": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "cardList": [
        {
            "omPrCardId": "0027f8615ca143a4967b98ee7dad1026", 
            "productId": "c933aabd0057483c8f0dc8da65c781b4", 
            "userInfoId": "b5ae3fed8f35419ab3e6c9521e631354", 
            "userName": "用户123", 
            "startDt": "1471881600000", 
            "endDt": "1471881600000", 
            "renewEndDt": "1471881600000", 
            "state": "1", 
            "remark": "", 
            "createDt": "1471881600000", 
            "cardType": "3"
    ]
}

查询车位出租信息列表接口

• 描述：
• •method：mgr.rentOut.queryPmSetRentList,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "totalCount": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true", 
    "pmSetRentList": [
        {
            "pmSetrentId": "0027f8615ca143a4967b98ee7dad1026", 
            "pmParkId": "c933aabd0057483c8f0dc8da65c781b4",
            "name": "包月123", 
            "content": "普通包月", 
            "buyMincount": "1", 
            "buyMaxcount": "11", 
            "unit": "4", 
            "amount": "4.33", 
            "canpayEndDate": "20161130"，
            "canpayEndTime": "235959"
    ]
}

查询车位出租成功订单数量接口

• 描述：
• •method：mgr.rentOut.countSuccessOmPrOrder,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "count": "10", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "msg": "操作成功"
}

支付宝购买车位支付接口

• 描述：
• •method：mgr.rentOut.aplipayQRcodePay,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "调用成功", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "prOrderPayRes": {
        "secuParam": "https://qr.alipay.com/bax08332hnn3fi21o53k20e0"
        "prPayId": "f05adf8740c24e788ede0b0b27cdedd0"
        "period": 300
        "payState": "CREATE"
    }
}

微信购买车位支付接口

• 描述：
• •method：mgr.rentOut.weixinQRcodePay,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "调用成功", 
    "returnMsg": "OK", 
    "isSuccess": "true",
    "prOrderPayRes": {
        "secuParam": "weixin://wxpay/bizpayurl?pr=Q2zjeek"
        "prPayId": "f05adf8740c24e788ede0b0b27cdedd0"
        "period": 300
        "payState": "CREATE"
    }
}

查询三方支付订单状态接口

• 描述：
• •method：mgr.rentOut.getOrderStats,请求方式：post
• 请求参数列表

• 响应参数列表

• 响应参数事例:

{
    "timestamp": "1463714771961", 
    "returnCode": "T", 
    "msg": "获取订单状态成功", 
    "returnMsg": "OK", 
    "isSuccess": "true"
}

停车场信息管理

查询停车场基本信息

• 描述：
• •method：mgr.rentOut.getParkInfoListByParam,请求方式：post
• 请求参数列表

* 响应参数列表

• 响应参数事例:

{
    "timestamp": "1462449578996",
    "returnCode": "T",
    "returnMsg": "OK",
    "isSuccess": "true",
    "parkList": [
        {
            "restCount": "54",
            "parkName": "首开知语城南湖中园317号停车场",
            "parkId": "2cd68b5611f742c79f7eae15d6f18728",
            "count": "54",
            "address": "湖兴中街与望京西路交叉口",
            "exitInfo": [
                {
                    "exitName": "A出入口",
                    "longitude": "116.46866",
                    "exitType": "2",
                    "latitude": "40.002603"
                }
            ],
            "longitude": "116.46866",
            "latitude": "40.002603",
            "firstHour": "5.0"
        },
        {
            "restCount": "470",
            "parkName": "圣馨大地家园停车场",
            "parkId": "321411ba0f5d4c01a8123f454b03ed7c",
            "count": "470",
            "address": "南湖南路9号",
            "exitInfo": [],
            "longitude": "116.469318",
            "latitude": "40.001526",
            "firstHour": "2.0"
        }
    ]
}