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

智舱停车业务停简单开发平台接口文档

内部文档，版权所有，请勿传播，违者必究

1. 约定

本文档为业务接口文档，完整请求需结合开放平台接入文档一起使用。
接口如无特殊说明，遵照以下规范:
金额格式统一为：(最大9位).(最多2位)。需要通过此正则表达式^((([1-9]{1}\\d{0,9}))|([0]{1}))((\\.(\\d){2}))?$。
isSuccess 返回结果说明：0=成功，1=业务失败，2=系统失败，其他标识=自定义失败。
本业务接口中，时间格式默认为：YYYYMMDDHHMISS
车牌颜色仅识别：blue|yellow|green|white|black
车牌号规则：6-9位
考虑到接口扩展情况，停简单提供的接口可能会扩展返回值，但是不会删除key和修改返回值类型，即会保证向下兼容，请调用方给予兼容操作。
接入方提供接口中，若停简单推送数据有向下兼容的变更(新增推送数据)，也请给予兼容。

2. 停简单提供接口

2.1 车辆服务

2.1.1 注册车牌

• 描述：接入方添加车牌到停简单系统，开通车牌数据权限，停简单会将此车牌进出场信息推送至接入方平台。
• service：parkhub.car.register
• 请求参数列表

* 请求参数示例：

{
    "service": "parkhub.car.register",
    "partner": "120a565de377427184de35ca0f320764",
    "sign": "3347b109a1e44f3fd5baa78b74184948",
    "signType": "md5",
    "charset": "utf-8",
    "version": "1.0",
    "timestamp": "2016-05-26 11:30:10",
    "carNum": "京A12345",
    "carNumColor": "blue",
    "phone": "13600000000",
    "outCarId": "432d85d7441346d29504f480e6a734a8"
}

• 响应参数列表

* 响应参数示例：

{
    "timestamp": "1464235239561",
    "returnCode": "T",
    "returnMsg": "OK",
    "isSuccess": "0",
    "errorMSG": "",
    "carId": "11ce3dca34124e97830ad466e532eda7"
}

2.1.2 注销车牌

• 描述：注销车牌将关闭车牌数据权限，此车牌进出场消息不再推送至接入方平台。
• service：parkhub.car.writeOff
• 请求参数列表

* 请求参数示例：

{
    "service": "parkhub.car.writeOff",
    "partner": "120a565de377427184de35ca0f320764",
    "sign": "3347b109a1e44f3fd5baa78b74a84948",
    "signType": "md5",
    "charset": "utf-8",
    "version": "1.0",
    "timestamp": "2016-05-26 11:30:10",
    "carId":"d24e8eb144a047bc99aa292033b2de45"
}

• 响应参数列表

* 响应参数示例：

{
    "timestamp": "1464235239561",
    "returnCode": "T",
    "returnMsg": "OK",
    "isSuccess": "0",
    "errorMSG": ""
}

2.2 停车场信息接口

2.2.1 根据地理位置查询停车场基本信息列表

• 描述：根据地理位置查询停车场基本信息列表
• service：park.getParkInfosByGeo
• 请求参数列表，最多查询一千条

* 响应参数列表

* 响应参数事例：

{
    "timestamp": "2017-05-11 16:00:38 255",
    "returnCode": "T",
    "returnMsg": "OK",
    "isSuccess": "true",
    "parkList": [
        {
            "pmParkId": "f716ab908b4a4c5b955b16baae844a2c",
            "parkName": "青岛市中国海洋大学鱼山校区停车场",
            "category": "1",
            "isOnlinePay": "0",
            "maxCount": "2500",
            "standardCount": "2500",
            "provinnce": "山东省",
            "city": "青岛市",
            "district": "市南区",
            "address": "市南区鱼山路5号",
            "longitude": "120.341766",
            "latitude": "36.069068",
            "parkType": "3",
            "wLongitude": "120.335299",
            "wLatitude": "36.062971",
            "openTime": "070000",
            "closeTime": "235959",
            "parktolls": [
                {
                    "carNumColor": "blue",
                    "dayFeeStartTime": "070000",
                    "dayFeeEndTime": "210000",
                    "dayFirstTime": "60",
                    "nightFirstTime": "60",
                    "dayFirstHour": "4.0",
                    "dayFirstMinTime": "30",
                    "dayFirstMinAmount": "2.0",
                    "dayOtherHour": "4.0",
                    "dayOtherMinTime": "30",
                    "dayOtherMinAmount": "2.0",
                    "nightFeeStartTime": "210000",
                    "nightFeeEndTime": "070000",
                    "nightFirstHour": "4.0",
                    "nightFirstMinTime": "30",
                    "nightFirstMinAmount": "2.0",
                    "nightOtherHour": "4.0",
                    "nightOtherMinTime": "30",
                    "nightOtherMinAmount": "2.0",
                    "dayFreeTime": "0",
                    "dayIntervalFreeTime": "0",
                    "nightFreeTime": "0",
                    "nightIntervalFreeTime": "0",
                    "maxAmount": "0.0"
                }
            ]
        },
        {
            "pmParkId": "b57db46803364c7cab04722aaa448656",
            "parkName": "青岛市红岛路31号停车场",
            "category": "1",
            "isOnlinePay": "0",
            "maxCount": "100",
            "standardCount": "100",
            "provinnce": "山东省",
            "city": "青岛市",
            "district": "市南区",
            "address": "青岛市市南区红岛路31号",
            "longitude": "120.345178",
            "latitude": "36.073369",
            "parkType": "3",
            "wLongitude": "120.338733",
            "wLatitude": "36.067213",
            "openTime": "070000",
            "closeTime": "235959",
            "parktolls": [
                {
                    "carNumColor": "blue",
                    "dayFeeStartTime": "070000",
                    "dayFeeEndTime": "210000",
                    "dayFirstTime": "60",
                    "nightFirstTime": "60",
                    "dayFirstHour": "4.0",
                    "dayFirstMinTime": "60",
                    "dayFirstMinAmount": "4.0",
                    "dayOtherHour": "4.0",
                    "dayOtherMinTime": "60",
                    "dayOtherMinAmount": "4.0",
                    "nightFeeStartTime": "210000",
                    "nightFeeEndTime": "070000",
                    "nightFirstHour": "4.0",
                    "nightFirstMinTime": "60",
                    "nightFirstMinAmount": "4.0",
                    "nightOtherHour": "4.0",
                    "nightOtherMinTime": "60",
                    "nightOtherMinAmount": "4.0",
                    "dayFreeTime": "0",
                    "dayIntervalFreeTime": "0",
                    "nightFreeTime": "0",
                    "nightIntervalFreeTime": "0",
                    "maxAmount": "80.0"
                }
            ]
        }
    ]
}

2.2.2 根据停车场id查询停车场相关信息

• 描述: 根据停车场id查询停车场相关信息
• service：park.getParkInfoByParkId
• 请求参数列表

• 响应参数列表

* 响应参数事例：

{
    "timestamp": "2017-05-11 16:00:38 255",
    "returnCode": "T",
    "returnMsg": "OK",
    "isSuccess": "true",
    "pmPark": {
            "pmParkId": "053b6f4dadda4ab7a859d6a085d2ccf1",
            "parkName": "青岛市市级机关新浦路停车场",
            "category": "1",
            "isOnlinePay": "0",
            "maxCount": "300",
            "standardCount": "260",
            "provinnce": "山东省",
            "city": "青岛市",
            "district": "市南区",
            "address": "青岛市市南区新浦路9号",
            "longitude": "120.391093",
            "latitude": "36.073982",
            "parkType": "3",
            "wLongitude": "120.384631",
            "wLatitude": "36.067883",
            "openTime": "070000",
            "closeTime": "235959",
            "parktolls": [
                {
                    "carNumColor": "blue",
                    "dayFeeStartTime": "070000",
                    "dayFeeEndTime": "210000",
                    "dayFirstTime": "60",
                    "nightFirstTime": "60",
                    "dayFirstHour": "4.0",
                    "dayFirstMinTime": "60",
                    "dayFirstMinAmount": "4.0",
                    "dayOtherHour": "4.0",
                    "dayOtherMinTime": "60",
                    "dayOtherMinAmount": "4.0",
                    "nightFeeStartTime": "210000",
                    "nightFeeEndTime": "070000",
                    "nightFirstHour": "4.0",
                    "nightFirstMinTime": "60",
                    "nightFirstMinAmount": "4.0",
                    "nightOtherHour": "4.0",
                    "nightOtherMinTime": "60",
                    "nightOtherMinAmount": "4.0",
                    "dayFreeTime": "0",
                    "dayIntervalFreeTime": "0",
                    "nightFreeTime": "0",
                    "nightIntervalFreeTime": "0",
                    "maxAmount": "20.0"
                }
            ]
        }
}

3. 接入方系统提供接口

3.1 返回值说明

• 描述：接入方系统提供的接口，需根据接口约定，返回指定格式数据。
• 支持的请求方式
  
  1. POST application/json 推荐
  2. POST application/x-www-form-urlencoded
  3. POST multipart/form-data
  4. GET
• 返回参数列表

* 返回值参数示例：

{
    "errorMSG": "",
    "isSuccess": "0"
}

3.2 车流消息

3.2.1 进场通知

• 描述：车辆进场，停简单通知接入方系统（当消息根据注册车牌订阅时：如果进场识别为黑牌车并且接入方没有注册黑牌车，但注册了同车牌号蓝牌车的情况下，依然会将黑牌车的进场信息推送到接入方系统）。
• 请求参数列表

* 请求参数示例：

{
    "parkId": "77a3424e06e64248b4cf9e490c8c682d",
    "parkName": "测试停车场",
    "carNum": "京A12345",
    "carNumColor ": "blue",
    "tradeId": "6d697f7579724345881633a00ed3a671",
    "outCarId": "",
    "inDt": "20180516213810",
    "payUrl": "http://prep.tingjiandan.com/tcweixin/letter/prePay/pagePayInPark?prePayType=16&channel=30000&isShowDetail=true&orderId=6d697f7579724345881633a00ed3a671&returnUrl=",
    "miniProgram": "{
        \"path\": \"pages/pre_pay/index/main\",
        \"extraData\": {
            \"prePayType\": \"16\",
            \"channel\": \"30000\",
            \"isShowDetail\": \"true\",
            \"orderId\": \"6d697f7579724345881633a00ed3a671\"
        }
    }",
    "canFindCar": "0",
    "city": "北京市",
    "district": "海淀区",
    "address": "五道口",
    "lon": "74.000272",
    "lat": "159.768703",
    "wLon": "123.523032",
    "wLat": "35.430735"
}

3.2.2 离场通知

• 描述：车辆出场后，停简单通知接入方系统。
• 请求参数列表

* 请求参数示例：

{
    "parkId": "77a3424e06e64248b4cf9e490c8c682d",
    "parkName": "测试停车场",
    "carNum": "京A12345",
    "carNumColor ": "blue",
    "tradeId": "6d697f7579724345881633a00ed3a671",
    "inDt": "20180516213810",
    "outDt": "20180516230521",
    "parkAmount": "5.00",
    "lon": "74.000272",
    "lat": "159.768703",
    "wLon": "123.523032",
    "wLat": "35.430735"
}