猫酷开放平台

# 车场

# 车辆入场

TIP

任何车辆入场后，无差别调起此入场通知接口，将车辆入场信息通知至猫酷。建议传入每次入场的TradeID，以便在车辆出场时准确对应入场记录，保证车辆生命周期信息准确性。

接口地址：https://openapi10.mallcoo.cn/Parking/V1/EnterInfoNotify/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
ParkCode string 是 车场编号（停车场系统中车场编号）
PlateNo string 是 车牌号（注：车牌号请注意编码，
编码格式为：UTF-8 (UrlEncode)）
InTime string 是 入场时间（yyyy-MM-dd HH:mm:ss）
TradeID string 否 车辆一次进出场的唯一编号
Brand string 否 汽车品牌（注：编码格式为：UTF-8 (UrlEncode)）
InAttr1 string 否 入场属性1（注：编码格式为：UTF-8 (UrlEncode)）
# 调用示例
{
  "ParkCode": "1",
  "PlateNo": "沪A68688",
  "InTime": "2017-03-27 14:30:19",
}
1
2
3
4
5
6

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6

# 重要状态码说明

Code 描述
1 入场成功
2 参数异常，请检查参数格式是否正确
1101 没有找到相关车场，请检查ParkCode是否正确



# 寻车

TIP

输入车牌号获取停车车位

接口地址：https://openapi10.mallcoo.cn/Parking/V1/GetCarLocation/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
PlateNo string 是 车牌号（注：车牌号请注意编码，编码格式为：UTF-8 (UrlEncode)）
# 调用示例

{
  "PlateNo": "沪A68688"
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
ParkID long 是 猫酷车场ID
ParkName string 是 车场名称
FloorID int 是 楼层ID
FloorName string 是 楼层名称
Area string 是 区域（A区、B区、C区）
PlateNo string 是 车牌号
SpaceNo string 是 车位号
CarImage string 是 停车图片
# 返回示例

{
    "Code": 1,
    "Data": [
        {
            "ParkID": 1,
            "ParkName": "车场",
            "FloorID": -6,
            "FloorName": "B3",
            "MapAreaID": "B3E083",
            "Area": "E区",
            "PlateNo": "鲁B892DY",
            "SpaceNo": "E083",
            "CarImage": "http://218.58.80.86:8099/FindCarSystem/RecognCarPlateFile/20170427/17/175_02/2017042717175_0204_35348.jpg"
        },
        {
            "ParkID": 1,
            "ParkName": "车场",
            "FloorID": -6,
            "FloorName": "B3",
            "MapAreaID": "B3E096",
            "Area": "E区",
            "PlateNo": "鲁B926KS",
            "SpaceNo": "E096",
            "CarImage": "http://218.58.80.86:8099/FindCarSystem/RecognCarPlateFile/20170427/16/171_01/2017042716171_0143_31590.jpg"
        }
    ],
    "Message": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30



# 缴费代扣

TIP

车辆需要出场时调起此代扣接口，进行车费的无感代扣。应缴费用为0元的车辆调起此接口也会正确响应（只能为在场车辆提供车费代扣）。如超过6秒钟或因网络中断等情况仍未返回结果，请用同样参数立即再次发起请求查询代扣结果。

该接口已支持以车牌号（PlateNo）做幂等性，所以同样车牌号在6.5分钟之内重复调用该接口时，会返回该车牌第一次调用时的结果。 如果超过6.5分钟再次发起代扣（此时使用不同的订单号），即使车牌相同，也会产生一笔新的订单导致重复用户扣费。

注：如对一辆车一次出场发起代扣后，需要再次以同样参数调用本接口查询本次扣费结果时，调用本接口时间间隔不得低于2秒

接口地址：https://openapi10.mallcoo.cn/Parking/V2/PayOrder/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
ParkCode string 是 车场编号（停车场系统中车场编号）
PlateNo string 是 车牌号（注：车牌号请注意编码，编码格式为：UTF-8 (UrlEncode)）
OutOrderNo string 是 订单编号（不得重复，保证提交的唯一性）
ParkingMinutes string 是 停车时长（单位：分钟，保留到整数）
ParkingTotalFee string 是 停车总费用（单位：分，保留到整数）
ParkingFee string 是 本次应付费用（单位：分，保留到整数）
PaidAmount string 是 已经支付费用（单位：分，保留到整数）
CarType int 否 此字段用以传输车牌类型(0蓝牌车，1新能源车，2黄牌车，3特殊车牌(军领学警)，4两地车牌(粤港澳))，如不传默认为0蓝牌车
# 调用示例

{
  "ParkCode": "1",
  "PlateNo": "沪A68688",
  "OutOrderNo": "201605061278654435466567",
  "ParkingMinutes": "65",
  "ParkingTotalFee": "1200",
  "ParkingFee": "1000",
  "PaidAmount": "200"
}
1
2
3
4
5
6
7
8
9
10
11

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OrderTradeNo string 是 猫酷停车场订单号
PaymentTradeNo string 是 支付交易编号（货币支付渠道所提供的订单号；未发生货币支付时，如优惠即抵扣完所有停车费则为字符串空）
ParkingFee string 是 本次应付停车费用（单位：分，保留到整数）
Deduction string 是 总优惠金额（单位：分，保留到整数）
PayMoney string 是 实付金额（单位：分，保留到整数）
PayType int 是 支付方式，如此订单未发生货币支付则支付方式为无支付方式，支付方式枚举可能会随业务的拓展而增加
0：无支付方式；
20：支付宝无感停车；
23：微信车主服务无感停车；
29：招行免密支付无感停车
IsFixed int 是 0订单交易成功可直接放行本车辆，1需要进行全额线下缴费，必须核对此字段，再做放行或线下缴费
# 返回示例

{
    "Code": 1,
    "Data": {
            "OrderTradeNo": "tde_park99_133C78201101012829122",
            "PaymentTradeNo": "4004472001201706267525410055",
            "ParkingFee": "1000",
            "Deduction": "500",
            "PayMoney": "500",
            "PayType":20,
			"IsFixed": 0
     },
    "Message": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 重要状态码说明

Code 描述
1 代扣接口已被正确执行，但仍需要判断IsFixed字段，来确定是否可抬杆放行
2 参数异常，请检查参数格式是否正确
1101 没有找到相关车场，请检查ParkCode是否正确
1129 订单支付中，请用同样参数重新发起调用获得支付结果(从第一次发起请求后15分钟内可再次用同样参数请求，从而得到第一次请求的结果)
1152 车辆未在场内，请先调用车辆入场接口
1163 请更换订单号(OutOrderNo) 请求
1165 订单支付中，请用同样参数重新发起调用获得支付结果(从第一次发起请求后15分钟内可再次用同样参数请求，从而得到第一次请求的结果)



# 车辆出场

TIP

任何车辆出场后，无差别调起此出场通知接口，将车辆出场信息通知至猫酷。建议传入该车辆本次入场时传入的同一TradeID，以便对应入场记录。

接口地址：https://openapi10.mallcoo.cn/Parking/V1/ExitInfoNotify/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
ParkCode string 是 车场编号（停车场系统中车场编号）
PlateNo string 是 车牌号（注：车牌号请注意编码，编码格式为：UTF-8 (UrlEncode)）
OutTime string 是 出场时间（yyyy-MM-dd HH:mm:ss）
TradeID string 否 车辆一次进出场的唯一编号
Brand string 否 汽车品牌（注：编码格式为：UTF-8 (UrlEncode)）
OutAttr1 string 否 出场属性1（注：编码格式为：UTF-8 (UrlEncode)）
# 调用示例

{
  "ParkCode": "1",
  "PlateNo": "沪A68688",
  "OutTime": "2017-03-27 16:25:38",
}
1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述

# 返回示例


{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6

# 重要状态码说明

Code 描述
1 出场成功
2 参数异常，请检查参数格式是否正确
1101 没有找到相关车场，请检查ParkCode是否正确



# 检查用户是否绑定车牌

TIP

检查用户是否绑定该车牌

接口地址：https://openapi10.mallcoo.cn/Parking/v1/CheckUserBindCar/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 是 手机号
PlateNo string 是 车牌号

# 调用示例


{
    "Mobile": "15901996271", 
    "PlateNo": "沪A000111"
}
1
2
3
4
5
6

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
IsBind bool 是 是否绑定
# 返回示例

{
  "Code": 1,
  "Data": {"IsBind":false},
  "Message": "成功"
}
1
2
3
4
5
6
7



# 通过车牌号查询绑定的会员

TIP

车场调用接口传入车牌号，响应绑定车牌的会员信息

接口地址：https://openapi10.mallcoo.cn/Parking/V1/GetMemberCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
ParkCode string 是 车场编号（停车场系统中车场编号）
PlateNo string 是 车牌号（注：车牌号请注意编码，编码格式为：UTF-8 (UrlEncode)）

# 调用示例


{
  "ParkCode": "1",
  "PlateNo": "沪A68688",
}
1
2
3
4
5
6

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
CardNo string 是 会员卡卡号
# 返回示例

{
    "Code": 1,
    "Data": {
        "CardNo": "mmm10000118",
    },
    "Message": null
}
1
2
3
4
5
6
7
8
9



# 猫酷方停车场订单详情查询

TIP

通过猫酷方提供的订单号来进行相关订单详细信息查询

接口地址：https://openapi10.mallcoo.cn/Parking/V1/OrderQuery/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
OrderTradeNo string 是 猫酷订单号

# 调用示例


{
  "OrderTradeNo": "tde_park0_1343EFD10008270365001"
}
1
2
3
4
5
6

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
PlateNo string 是 车牌号/磁卡/小票号
ParkName string 是 车场名称
EntryTime string 是 入场时间
ParkingMinutes int 是 停车时长(分钟)
ParkingTotalFee double 是 停车总费用（分）
FreeMinutes int 是 总优惠时长（分钟）
FreeAmount double 是 总免费金额（分）
OrderStatus string 是 订单状态
PayType string 是 支付方式
OrderPrice int 是 订单金额（分）
CreateTime string 是 订单创建时间
DeductionDetails List<DeductionDetail> 是 使用优惠明细集合
# DeductionDetail
名称 数据类型 必填 说明
Name string 是 优惠名称
Minutes int 是 优惠抵扣时长（分钟）
Amount int 是 优惠抵扣金额（分）
# 返回示例

{
    "Code":1,
    "Data":{
        "CreateTime":"2020-12-29 14:06:02",
        "DeductionDetails":[
            {
                "Amount":100,
                "Minutes":0,
                "Name":"新城积分"
            }
        ],
        "EntryTime":"2020-12-29 13:06:02",
        "FreeAmount":100,
        "FreeMinutes":0,
        "OrderPrice":0,
        "OrderStatus":"交易成功",
        "ParkName":"上海猫酷南楼停车场",
        "ParkingMinutes":60,
        "ParkingTotalFee":1,
        "PayChannel":"线上缴费",
        "PayTime":"2020-12-29 14:06:03",
        "PayType":"无",
        "PlateNo":"粤SWWWWW"
    },
    "Message":null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Last Updated: 2021/5/6 下午2:58:52

← 电影 →