停车平台接口

1. 车辆管理

1.1 添加车辆

接口地址：POST /open-api/parking/add-car

接口说明：通过此接口将车辆信息添加到EPO平台

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string	N		车场编号
vehicleCode	string	N		车牌号
vehicleType	string	N		车辆类型月租车：1 免费车：2 支持传入接口4.13的自定义车辆类型id
diyTypeName	String			车辆类型自定义显示名称，此参数优先级高于vehicleType
userName	string	N		车主姓名
userPhoneNumber	string	N		车主手机号
startTime	string	N		授权开始时间（yyyy-MM-dd）
endTime	string	N		授权结束时间（yyyy-MM-dd）
laneNos	string	Y		可通行车道（为空默认全部可通行，多个车道时用英文逗号分隔）
lotNum	int	Y	1	车主总车位数
remark	string	Y		备注
workNum	String	Y		车主工号
deptName	String	Y		车主所在部门

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

1.2 修改车辆

1.1 添加车辆

接口地址：POST /open-api/parking/update-car

接口说明：通过此接口修改EPO平台中的车辆信息

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string	N		车场编号
vehicleCode	string	N		车牌号
vehicleType	string	N		车辆类型月租车：1 免费车：2
diyTypeName	String			车辆类型自定义显示名称，此参数优先级高于vehicleType
userName	string	N		车主姓名
userPhoneNumber	string	N		车主手机号
startTime	string	N		授权开始时间（yyyy-MM-dd）
endTime	string	N		授权结束时间（yyyy-MM-dd）
laneNos	string	Y		可通行车道（为空默认全部可通行，多个车道时用英文逗号分隔）
lotNum	int	Y	1	车主总车位数
remark	string	Y		备注
workNum	String	Y		车主工号
deptName	String	Y		车主所在部门

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

1.3 删除车辆

接口地址：POST /open-api/parking/delete-car

接口说明：通过此接口将车辆信息从EPO平台删除

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string	N		车场编号
vehicleCode	string	N		车牌号

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

2. 获取车辆列表

接口地址：POST /open-api/parking/vehicle-list

接口说明：通过此接口获取当前车场的在场车辆列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	描述
parkingId	string	必传
pageNo	int	页码
pageSize	int	每页最大1000条

返回数据

名称	类型	可空	默认	描述
code	int			0成功 1失败
msg	string
result	Object			返回结果
+has_more	boolean			是否还有更多数据 true:有 false:没有
+data	Object[]
++vehicleCode	string	N		车牌号
++vehicleType	string	N		车辆类型月租车：1 免费车：2
++userName	string	N		车主姓名
++workNo	string			工号
++userPhoneNumber	string	N		车主手机号
++startTime	string	N		授权开始时间（yyyy-MM-dd）
++endTime	string	N		授权结束时间（yyyy-MM-dd）
++laneNos	string	Y		可通行车道（为空默认全部可通行，多个车道时用英文逗号分隔）
++lotNum	int	Y	1	车主总车位数
++remark	string	Y		备注

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "hasMore": true,
    "data": [
      {
        "vehicleCode": "鲁A12345",
        "vehicleType": "1",
        "userName": "张三",
        "workNo": "10001",
        "userPhoneNumber": "13800138000",
        "startTime": "2025-01-01",
        "endTime": "2025-12-31",
        "laneNos": "1,2",
        "lotNum": 1,
        "remark": "公司公务车"
      },
      {
        "vehicleCode": "鲁A12346",
        "vehicleType": "2",
        "userName": "李四",
        "workNo": "10002",
        "userPhoneNumber": "13900139000",
        "startTime": "2025-01-01",
        "endTime": "2025-12-31",
        "laneNos": "",
        "lotNum": 1,
        "remark": ""
      }
    ]
  }
}

3. 车辆进出回调数据

接口说明：接口2提供的回调url需接受 post application/json请求

请求数据

header域

名称	类型	可空	描述
appKey	String	N	平台分配
timestamp	Long	N	当前时间，Unix毫秒时间戳
sign	String	N	MD5-32(appKey+timestamp+appSecret),32小写

body域

名称	类型	可空	描述
callbackType	String	N	PARKING_VEHICLE_ACCESS
data	对象	N
+vehicleCode	string	N	车牌号
+vehicleType	string	N	车辆类型月租车：1 免费车：2
+accessType	string	N	进出方向 0进 1出
+time	string	N	进出时间yyyy-MM-dd HH:mm:ss
+laneNo	string	N	车道编号
+laneName	string	N	车道名称
+photo	string	N	识别照片
+parkingId	string	N	车场编号
+userName	string	N	车主姓名
+tempLot	Int	N	临时车可用车位数
+inParkNum	Int	N	在场车辆数量
+totalLot	Int	N	总可用车位数
+phoneNum	string	N	车主手机号

示例数据

{
  "callbackType": "PARKING_VEHICLE_ACCESS",
  "data": {
    "vehicleCode": "鲁A12345",
    "vehicleType": "1",
    "accessType": "1",
    "time": "2025-03-15 08:30:00",
    "laneNo": "1",
    "laneName": "入口车道1",
    "photo": "http://example.com/photo.jpg",
    "parkingId": "park123",
    "userName": "张三",
    "tempLot": 50,
    "inParkNum": 120,
    "totalLot": 200,
    "phoneNum": "13800138000"
  }
}

4. 相机离线回调数据

接口说明：接口2提供的回调url需接受 post application/json请求

请求数据

header域

名称	类型	可空	描述
appKey	String	N	平台分配
timestamp	Long	N	当前时间，Unix毫秒时间戳
sign	String	N	MD5-32(appKey+timestamp+appSecret),32小写

body域

名称	类型	可空	描述
callbackType	String	N	PARKING_CAMERA_ONLINE
data	对象	N
+parkingId	string	N	车场编号
+laneNo	string	N	车道编号
+laneName	string	N	车道名称
+time	String	N	发生时间 yyyy-MM-dd HH:mm:ss
+status	string	N	状态 0离线 1在线

示例数据

{
  "callbackType": "PARKING_CAMERA_ONLINE",
  "data": {
    "parkingId": "park123",
    "laneNo": "1",
    "laneName": "入口车道1",
    "time": "2025-03-15 09:00:00",
    "status": "0"
  }
}

5. 访客预约回调数据（已废弃）

接口说明：接口2提供的回调url需接受 post application/json请求

请求数据

header域

名称	类型	可空	描述
appKey	String	N	平台分配
timestamp	Long	N	当前时间，Unix毫秒时间戳
sign	String	N	MD5-32(appKey+timestamp+appSecret),32小写

body域

名称	类型	可空	描述
callbackType	String	N	PARKING_VISITOR
data	对象	N
+parkingId	string	N	车场编号
+vehicleCode	string	N	车牌号
+userName	string	N	联系人
+userPhoneNumber	string	N	联系电话
+startTime	string	N	授权开始时间（yyyy-MM-dd）
+endTime	string	N	授权结束时间（yyyy-MM-dd）
+memo	string	N	来访事由

示例数据

{
  "callbackType": "PARKING_VISITOR",
  "data": {
    "parkingId": "park123",
    "vehicleCode": "鲁A12345",
    "userName": "王五",
    "userPhoneNumber": "13700137000",
    "startTime": "2025-03-15",
    "endTime": "2025-03-16",
    "memo": "业务拜访"
  }
}

6. 获取在场车辆

接口地址：POST /open-api/parking/inparking-car-list

接口说明：通过此接口获取当前车场的在场车辆列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	描述
parkingId	string	多车场必传
pageNo	int	页码
pageSize	int	每页最大1000条

返回数据

名称	类型	描述
code	int	0成功 1失败
msg	string
result	Object	返回结果
+has_more	boolean	是否还有更多数据 true:有 false:没有
+data	Object[]
++laneNo	string	车道编号
++vehicleCode	string
++vehicleType	string	车辆类型月租车：1 免费车：2 临时车：9
++intime	string	入场时间：yyyy-MM-dd HH:mm:ss

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "hasMore": true,
    "data": [
      {
        "laneNo": "1",
        "vehicleCode": "鲁A12345",
        "vehicleType": "1",
        "intime": "2021-10-2 15:30:49"
      },
      {
       "laneNo": "1",
       "vehicleCode": "鲁A12346",
        "vehicleType": "9",
        "intime": "2021-10-2 16:30:49"
      }
    ]
  }
}

7. 获取访客车辆信息

接口地址：POST /open-api/parking/visitor-car-info

接口说明：通过此接口获取访客车辆的信息，只返回审核通过后的数据

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	描述
parkingId	string	Y	多车场必传
vehicleCode	String	N	车牌号
time	string	Y	车牌识别时间（yyyy-MM-dd HH:mm:ss）

返回数据

名称	类型	可空	描述
code	int		0成功 1失败
msg	string
result	Object		返回结果
+parkingId	string	N	车场编号
+vehicleCode	string	N	车牌号
+userName	string	N	联系人
+userPhoneNumber	string	N	联系电话
+startTime	string	N	授权开始时间（yyyy-MM-dd HH:mm）
+endTime	string	N	授权结束时间（yyyy-MM-dd HH:mm）
+memo	string	N	来访事由
+otherInfo	Object
++ext1	string		拓展信息1
++ext2	string		拓展信息2
++ext3	string		拓展信息3
++ext4	string		拓展信息4
++ext5	string		拓展信息5
++ext6	string		拓展信息6
++ext7	string		拓展信息7
++ext8	string		拓展信息8
++ext9	string		拓展信息9
++ext10	string		拓展信息10

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "parkingId": "park123",
    "vehicleCode": "鲁A12345",
    "userName": "赵六",
    "userPhoneNumber": "13600136000",
    "startTime": "2025-03-15 09:00",
    "endTime": "2025-03-15 18:00",
    "memo": "技术交流",
    "otherInfo": {
      "ext1": "扩展信息1",
      "ext2": "扩展信息2",
      "ext3": "扩展信息3",
      "ext4": "扩展信息4",
      "ext5": "扩展信息5"
    }
  }
}

8. 获取停车场车位统计

接口地址：POST /open-api/parking/parking-lot-statistics

接口说明：通过此接口获取当前车场的车位统计

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string			多车场必传

返回数据

名称	类型	描述
code	int	0成功 1失败
msg	string
data	Object	返回结果
+totalLot	int	总车位数
+usedLot	Int	已用车位数
+visitorUsedLot	Int	访客已用车位数
+mothTotalLot	Int	内部员工车位数
+mothUsedLot	Int	已使用内部员工车位数
+tempLot	Int	临时车位数

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "totalLot": 500,
    "usedLot": 300,
    "visitorUsedLot": 50,
    "mothTotalLot": 300,
    "mothUsedLot": 200,
    "tempLot": 200
  }
}

9. 获取车道列表

接口地址：POST /open-api/parking/list-lanes

接口说明：通过此接口获取当前车场的所有车道

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string			多车场必传

返回数据

名称	类型	描述
code	int	0成功 1失败
msg	string
data	Object	返回结果
+laneNo	String	车道编号
+laneName	String	车道名称

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "laneNo": "1",
      "laneName": "入口车道1"
    },
    {
      "laneNo": "2",
      "laneName": "出口车道1"
    }
  ]
}

10. 黑名单车辆管理(内测中)

10.1 添加黑名单车辆

接口地址：POST /open-api/parking/add-blacklist-plate

接口说明：通过此接口将车辆信息添加到黑名单，黑名单车辆将无法进出

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	描述
parkingId	string	N	车场编号
vehicleCode	string	N	车牌号
stopTime	string	N	截止时间，格式：yyyy-MM-dd

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

10.2 删除黑名单车辆

接口地址：POST /open-api/parking/delete-blacklist-plate

接口说明：通过此接口将车辆信息从黑名单车辆中移除

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string	N		车场编号
vehicleCode	string	N		车牌号

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

10.3 获取黑名单车辆列表

接口地址：POST /open-api/parking/list-blacklist-plate

接口说明：通过此接口获取当前车场的黑名单车辆列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	描述
parkingId	string	多车场必传
pageNo	int	页码
pageSize	int	每页最大1000条

返回数据

名称	类型	描述
code	int	0成功 1失败
msg	string
result	Object	返回结果
+has_more	boolean	是否还有更多数据 true:有 false:没有
+data	Object[]
++vehicleCode	String	车牌号
++stopTime	String	截止时间，格式：yyyy-MM-dd

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "hasMore": true,
    "data": [
      {
        "vehicleCode": "鲁A12345",
        "stopTime": "2023-09-12"
      },
      {
        "vehicleCode": "鲁A12346",
        "stopTime": "2023-09-12"
      }
    ]
  }
}

11. 获取停车场列表

接口地址：POST /open-api/parking/park-list

接口说明：通过此接口获取组织下的停车场列表数据

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

返回数据

名称	类型	可空	描述
code	Int	N	0成功，1失败
msg	String		提示信息
result	数组	N
+value	String	N	车场Id
+text	String	N	车场名称

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": [
    {
      "value": "park1",
      "text": "一号停车场"
    },
    {
      "value": "park2",
      "text": "二号停车场"
    }
  ]
}

12. 获取车辆进出数据

接口地址：POST /open-api/parking/vehicle-access-list

接口说明：通过此接口获取当前车场的车辆进出数据列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	描述
parkingId	string	必传
pageNo	int	页码
pageSize	int	每页最大1000条
startTime	string	开始时间，yyyy-MM-dd HH:mm:ss
endTime	String	结束时间，yyyy-MM-dd HH:mm:ss 注意：开始时间和结束时间差不能超过24小时

返回数据

名称	类型	可空	描述
code	int		0成功 1失败
msg	string
result	Object		返回结果
+has_more	boolean		是否还有更多数据 true:有 false:没有
+data	Object[]
++recordId	long		进出记录id
++vehicleCode	string	N	车牌号
++vehicleType	string	N	车辆类型月租车：1 免费车：2
++accessType	string	N	进出方向 1进 2出
++time	string	N	进出时间yyyy-MM-dd HH:mm:ss
++laneNo	string	N	车道编号
++laneName	string	N	车道名称
++photo	string	N	识别照片
++parkingId	string	N	车场编号
++userName	string	N	车主姓名
++workNo	string		工号
++phoneNum	string	N	车主手机号

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "hasMore": true,
    "data": [
      {
        "recordId": 123456,
        "vehicleCode": "鲁A12345",
        "vehicleType": "1",
        "accessType": "1",
        "time": "2025-03-15 08:30:00",
        "laneNo": "1",
        "laneName": "入口车道1",
        "photo": "http://example.com/photo1.jpg",
        "parkingId": "park123",
        "userName": "张三",
        "workNo": "10001",
        "phoneNum": "13800138000"
      },
      {
        "recordId": 123457,
        "vehicleCode": "鲁A12346",
        "vehicleType": "2",
        "accessType": "2",
        "time": "2025-03-15 09:30:00",
        "laneNo": "2",
        "laneName": "出口车道1",
        "photo": "http://example.com/photo2.jpg",
        "parkingId": "park123",
        "userName": "李四",
        "workNo": "10002",
        "phoneNum": "13900139000"
      }
    ]
  }
}

13. 查询自定义车辆类型数据

接口地址：POST /open-api/parking/vehicle-type-list

接口说明：通过此接口获取当前车场的自定义车辆类型列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
parkingId	string			必传

返回数据

名称	类型	可空	描述
code	int		0成功 1失败
msg	string
result	Object		返回结果
+has_more	boolean		是否还有更多数据 true:有 false:没有
+data	Object[]
++recordId	long		自定义车辆类型id
++vehicleTypeCode	string	N	车辆类型编码
++vehicleTypeName	string	N	车辆类型名称
++showName	string	N	自定义车辆类型显示名称

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "result": {
    "hasMore": false,
    "data": [
      {
        "recordId": 1,
        "vehicleTypeCode": "VIP",
        "vehicleTypeName": "贵宾车",
        "showName": "贵宾专用车"
      },
      {
        "recordId": 2,
        "vehicleTypeCode": "EMS",
        "vehicleTypeName": "邮政车",
        "showName": "邮政快递车"
      }
    ]
  }
}

14. 下发车辆优惠券

接口地址：POST /open-api/parking/add-coupon

接口说明：通过此接口向指定车牌号下发优惠券

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	描述
parkingId	string	N	车场id必传
vehicleCode	string	N	车牌号
couponType	int	N	优惠券类型 1次券 2小时券 3金额券
discount	int	N	优惠券面值小时券：单位为小时次券：单位为次金额券：单位为元
expireTime	string	Y	到期时间 yyyy-MM-dd HH:mm 不传则永久有效

返回数据

名称	类型	可空	默认	描述
code	int			0成功 1失败
msg	string

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

15. 外出申请

接口地址：POST /open-api/parking/egress-application

接口说明：通过此接口给指定车辆申请外出权限

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	描述
parkingId	string	N	车场id必传
vehicleCode	string	N	车牌号
startTime	String	N	外出开始时间(yyyy-MM-dd HH:mm)
endTime	String	N	外出结束时间(yyyy-MM-dd HH:mm)

返回数据

名称	类型	可空	默认	描述
code	int			0成功 1失败
msg	string

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

16. 开闸

接口地址：POST /open-api/parking/open-gate

接口说明：通过此接口给指定通道开闸

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
laneId	string	N		车道id

返回数据

名称	类型	可空	默认	描述
code	int			0成功 1失败
msg	string

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

1. 车辆管理#

1.1 添加车辆#

1.2 修改车辆#

1.1 添加车辆#

1.3 删除车辆#

2. 获取车辆列表#

3. 车辆进出回调数据#

4. 相机离线回调数据#

5. 访客预约回调数据（已废弃）#

6. 获取在场车辆#

7. 获取访客车辆信息#

8. 获取停车场车位统计#

9. 获取车道列表#

10. 黑名单车辆管理(内测中)#

10.1 添加黑名单车辆#

10.2 删除黑名单车辆#

10.3 获取黑名单车辆列表#

11. 获取停车场列表#

12. 获取车辆进出数据#

13. 查询自定义车辆类型数据#

14. 下发车辆优惠券#

15. 外出申请#

16. 开闸#

1. 车辆管理

1.1 添加车辆

1.2 修改车辆

1.1 添加车辆

1.3 删除车辆

2. 获取车辆列表

3. 车辆进出回调数据

4. 相机离线回调数据

5. 访客预约回调数据（已废弃）

6. 获取在场车辆

7. 获取访客车辆信息

8. 获取停车场车位统计

9. 获取车道列表

10. 黑名单车辆管理(内测中)

10.1 添加黑名单车辆

10.2 删除黑名单车辆

10.3 获取黑名单车辆列表

11. 获取停车场列表

12. 获取车辆进出数据

13. 查询自定义车辆类型数据

14. 下发车辆优惠券

15. 外出申请

16. 开闸