EPO平台开放接口
    EPO平台开放接口
    • 文档概述
    • 快速入门
    • 基础接口(必须)
    • 停车平台接口
    • 会议平台接口
    • 访客平台接口
    • 消费平台接口
    • 视频监控接口
    • 分析平台接口
    • 无感考勤
    • 附录

    停车平台接口

    1. 车辆管理#

    1.1 添加车辆#

    接口地址:POST /open-api/parking/add-car
    接口说明:通过此接口将车辆信息添加到EPO平台
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场编号
    vehicleCodestringN车牌号
    vehicleTypestringN车辆类型

    月租车:1

    免费车:2

    支持传入接口4.13的自定义车辆类型id
    diyTypeNameString车辆类型自定义显示名称,此参数

    优先级高于vehicleType
    userNamestringN车主姓名
    userPhoneNumberstringN车主手机号
    startTimestringN授权开始时间(yyyy-MM-dd)
    endTimestringN授权结束时间(yyyy-MM-dd)
    laneNosstringY可通行车道(为空默认全部可通行,多个车道时用英文逗号分隔)
    lotNumintY1车主总车位数
    remarkstringY备注
    workNumStringY车主工号
    deptNameStringY车主所在部门
    返回数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    1.2 修改车辆#

    1.1 添加车辆#

    接口地址:POST /open-api/parking/update-car
    接口说明:通过此接口修改EPO平台中的车辆信息
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场编号
    vehicleCodestringN车牌号
    vehicleTypestringN车辆类型

    月租车:1

    免费车:2
    diyTypeNameString车辆类型自定义显示名称,此参数

    优先级高于vehicleType
    userNamestringN车主姓名
    userPhoneNumberstringN车主手机号
    startTimestringN授权开始时间(yyyy-MM-dd)
    endTimestringN授权结束时间(yyyy-MM-dd)
    laneNosstringY可通行车道(为空默认全部可通行,多个车道时用英文逗号分隔)
    lotNumintY1车主总车位数
    remarkstringY备注
    workNumStringY车主工号
    deptNameStringY车主所在部门
    返回数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    1.3 删除车辆#

    接口地址:POST /open-api/parking/delete-car
    接口说明:通过此接口将车辆信息从EPO平台删除
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场编号
    vehicleCodestringN车牌号
    返回数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    2. 获取车辆列表#

    接口地址:POST /open-api/parking/vehicle-list
    接口说明:通过此接口获取当前车场的在场车辆列表
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring必传
    pageNoint页码
    pageSizeint每页最大1000条
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +has_moreboolean是否还有更多数据

    true:有

    false:没有
    +dataObject[]
    ++vehicleCodestringN车牌号
    ++vehicleTypestringN车辆类型

    月租车:1

    免费车:2
    ++userNamestringN车主姓名
    ++workNostring工号
    ++userPhoneNumberstringN车主手机号
    ++startTimestringN授权开始时间(yyyy-MM-dd)
    ++endTimestringN授权结束时间(yyyy-MM-dd)
    ++laneNosstringY可通行车道(为空默认全部可通行,多个车道时用英文逗号分隔)
    ++lotNumintY1车主总车位数
    ++remarkstringY备注
    示例数据
    {
      "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域
    名称类型可空默认描述
    appKeyStringN平台分配
    timestampLongN当前时间,Unix毫秒时间戳
    signStringNMD5-32(appKey+timestamp+appSecret),32小写
    body域
    名称类型可空默认描述
    callbackTypeStringNPARKING_VEHICLE_ACCESS
    data对象N
    +vehicleCodestringN车牌号
    +vehicleTypestringN车辆类型

    月租车:1

    免费车:2
    +accessTypestringN进出方向 1进 2出
    +timestringN进出时间yyyy-MM-dd HH:mm:ss
    +laneNostringN车道编号
    +laneNamestringN车道名称
    +photostringN识别照片
    +parkingIdstringN车场编号
    +userNamestringN车主姓名
    +tempLotIntN临时车可用车位数
    +inParkNumIntN在场车辆数量
    +totalLotIntN总可用车位数
    +phoneNumstringN车主手机号
    示例数据
    {
      "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域
    名称类型可空默认描述
    appKeyStringN平台分配
    timestampLongN当前时间,Unix毫秒时间戳
    signStringNMD5-32(appKey+timestamp+appSecret),32小写
    body域
    名称类型可空默认描述
    callbackTypeStringNPARKING_CAMERA_ONLINE
    data对象N
    +parkingIdstringN车场编号
    +laneNostringN车道编号
    +laneNamestringN车道名称
    +timeStringN发生时间 yyyy-MM-dd HH:mm:ss
    +statusstringN状态 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域
    名称类型可空默认描述
    appKeyStringN平台分配
    timestampLongN当前时间,Unix毫秒时间戳
    signStringNMD5-32(appKey+timestamp+appSecret),32小写
    body域
    名称类型可空默认描述
    callbackTypeStringNPARKING_VISITOR
    data对象N
    +parkingIdstringN车场编号
    +vehicleCodestringN车牌号
    +userNamestringN联系人
    +userPhoneNumberstringN联系电话
    +startTimestringN授权开始时间(yyyy-MM-dd)
    +endTimestringN授权结束时间(yyyy-MM-dd)
    +memostringN来访事由
    示例数据
    {
      "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域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring多车场必传
    pageNoint页码
    pageSizeint每页最大1000条
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +has_moreboolean是否还有更多数据

    true:有

    false:没有
    +dataObject[]
    ++vehicleCodestring
    ++vehicleTypestring车辆类型

    月租车:1

    免费车:2

    临时车:9
    ++intimestring入场时间:yyyy-MM-dd HH:mm:ss
    示例数据
    {
      "code": 0,
      "msg": "操作成功",
      "result": {
        "hasMore": true,
        "data": [
          {
            "vehicleCode": "鲁A12345",
            "vehicleType": "1",
            "intime": "2021-10-2 15:30:49"
          },
          {
            "vehicleCode": "鲁A12346",
            "vehicleType": "9",
            "intime": "2021-10-2 16:30:49"
          }
        ]
      }
    }

    7. 获取访客车辆信息#

    接口地址:POST /open-api/parking/visitor-car-info
    接口说明:通过此接口获取访客车辆的信息,只返回审核通过后的数据
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringY多车场必传
    vehicleCodeStringN车牌号
    timestringY车牌识别时间(yyyy-MM-dd HH:mm:ss)
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +parkingIdstringN车场编号
    +vehicleCodestringN车牌号
    +userNamestringN联系人
    +userPhoneNumberstringN联系电话
    +startTimestringN授权开始时间(yyyy-MM-dd HH:mm)
    +endTimestringN授权结束时间(yyyy-MM-dd HH:mm)
    +memostringN来访事由
    +otherInfoObject
    ++ext1string拓展信息1
    ++ext2string拓展信息2
    ++ext3string拓展信息3
    ++ext4string拓展信息4
    ++ext5string拓展信息5
    ++ext6string拓展信息6
    ++ext7string拓展信息7
    ++ext8string拓展信息8
    ++ext9string拓展信息9
    ++ext10string拓展信息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域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring多车场必传
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    dataObject返回结果
    +totalLotint总车位数
    +usedLotInt已用车位数
    +visitorUsedLotInt访客已用车位数
    +mothTotalLotInt内部员工车位数
    +mothUsedLotInt已使用内部员工车位数
    +tempLotInt临时车位数
    示例数据
    {
      "code": 0,
      "msg": "操作成功",
      "data": {
        "totalLot": 500,
        "usedLot": 300,
        "visitorUsedLot": 50,
        "mothTotalLot": 300,
        "mothUsedLot": 200,
        "tempLot": 200
      }
    }

    9. 获取车道列表#

    接口地址:POST /open-api/parking/list-lanes
    接口说明:通过此接口获取当前车场的所有车道
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring多车场必传
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    dataObject返回结果
    +laneNoString车道编号
    +laneNameString车道名称
    示例数据
    {
      "code": 0,
      "msg": "操作成功",
      "data": [
        {
          "laneNo": "1",
          "laneName": "入口车道1"
        },
        {
          "laneNo": "2",
          "laneName": "出口车道1"
        }
      ]
    }

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

    10.1 添加黑名单车辆#

    接口地址:POST /open-api/parking/add-blacklist-plate
    接口说明:通过此接口将车辆信息添加到黑名单,黑名单车辆将无法进出
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场编号
    vehicleCodestringN车牌号
    stopTimestringN截止时间,格式:yyyy-MM-dd
    返回数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    10.2 删除黑名单车辆#

    接口地址:POST /open-api/parking/delete-blacklist-plate
    接口说明:通过此接口将车辆信息从黑名单车辆中移除
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场编号
    vehicleCodestringN车牌号
    返回数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    10.3 获取黑名单车辆列表#

    接口地址:POST /open-api/parking/list-blacklist-plate
    接口说明:通过此接口获取当前车场的黑名单车辆列表
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring多车场必传
    pageNoint页码
    pageSizeint每页最大1000条
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +has_moreboolean是否还有更多数据

    true:有

    false:没有
    +dataObject[]
    ++vehicleCodeString车牌号
    ++stopTimeString截止时间,格式: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域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    返回数据
    名称类型可空默认描述
    codeIntN0成功,1失败
    msgString提示信息
    result数组N
    +valueStringN车场Id
    +textStringN车场名称
    示例数据
    {
      "code": 0,
      "msg": "操作成功",
      "result": [
        {
          "value": "park1",
          "text": "一号停车场"
        },
        {
          "value": "park2",
          "text": "二号停车场"
        }
      ]
    }

    12. 获取车辆进出数据#

    接口地址:POST /open-api/parking/vehicle-access-list
    接口说明:通过此接口获取当前车场的车辆进出数据列表
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring必传
    pageNoint页码
    pageSizeint每页最大1000条
    startTimestring开始时间,yyyy-MM-dd HH:mm:ss
    endTimeString结束时间,yyyy-MM-dd HH:mm:ss

    注意:开始时间和结束时间差不能超过24小时
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +has_moreboolean是否还有更多数据

    true:有

    false:没有
    +dataObject[]
    ++recordIdlong进出记录id
    ++vehicleCodestringN车牌号
    ++vehicleTypestringN车辆类型

    月租车:1

    免费车:2
    ++accessTypestringN进出方向 1进 2出
    ++timestringN进出时间yyyy-MM-dd HH:mm:ss
    ++laneNostringN车道编号
    ++laneNamestringN车道名称
    ++photostringN识别照片
    ++parkingIdstringN车场编号
    ++userNamestringN车主姓名
    ++workNostring工号
    ++phoneNumstringN车主手机号
    示例数据
    {
      "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域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstring必传
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    resultObject返回结果
    +has_moreboolean是否还有更多数据

    true:有

    false:没有
    +dataObject[]
    ++recordIdlong自定义车辆类型id
    ++vehicleTypeCodestringN车辆类型编码
    ++vehicleTypeNamestringN车辆类型名称
    ++showNamestringN自定义车辆类型显示名称
    示例数据
    {
      "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域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场id必传
    vehicleCodestringN车牌号
    couponTypeintN优惠券类型

    1次券

    2小时券

    3金额券
    discountintN优惠券面值

    小时券:单位为小时

    次券:单位为次

    金额券:单位为元
    expireTimestringY到期时间

    yyyy-MM-dd HH:mm

    不传则永久有效
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    示例数据
    {
      "code": 0,
      "msg": "操作成功"
    }

    15. 外出申请#

    接口地址:POST /open-api/parking/egress-application
    接口说明:通过此接口给指定车辆申请外出权限
    请求数据
    header域
    名称类型可空默认描述
    AccessTokenStringN接口1获取
    body域
    名称类型可空默认描述
    parkingIdstringN车场id必传
    vehicleCodestringN车牌号
    startTimeStringN外出开始时间(yyyy-MM-dd HH:mm)
    endTimeStringN外出结束时间(yyyy-MM-dd HH:mm)
    返回数据
    名称类型可空默认描述
    codeint0成功 1失败
    msgstring
    示例数据
    {
      "code": 0,
      "msg": "操作成功"
    }
    修改于 2025-12-04 13:12:24
    上一页
    基础接口(必须)
    下一页
    会议平台接口
    Built with