车辆管理接口文档

基础信息

Base URL: http://localhost:端口号
Content-Type: application/json
认证方式: 需要登录（请求头携带 token）

数据字典 - 车辆使用状态

枚举值	含义
`IDLE`	空闲
`IN_USE`	使用中
`MAINTENANCE`	维修中
`SCRAPPED`	已报废

1. 分页查询车辆列表

请求信息

URL: /approve/vehicle/listPage
Method: GET

请求参数（Query String）

参数名	类型	必填	说明
current	Long	是	当前页码，默认1
size	Long	是	每页条数，默认10
plateNumber	String	否	车牌号（模糊查询）
status	String	否	使用状态（精确匹配）

请求示例

GET /approve/vehicle/listPage?current=1&size=10&plateNumber=京&status=IN_USE

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "records": [
      {
        "id": 1,
        "plateNumber": "京A12345",
        "mileage": 52000.00,
        "status": "IN_USE",
        "deleted": 0,
        "createUser": 1,
        "createTime": "2026-05-28 10:00:00",
        "updateUser": 1,
        "updateTime": "2026-05-28 10:00:00",
        "deptId": 100
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "pages": 1
  }
}

2. 新增车辆

请求信息

URL: /approve/vehicle/save
Method: POST
Content-Type: application/json

请求体参数

参数名	类型	必填	说明
plateNumber	String	是	车牌号
mileage	Number	否	车辆公里数，默认0
status	String	是	使用状态：IDLE / IN_USE / MAINTENANCE / SCRAPPED

请求示例

{
  "plateNumber": "京A12345",
  "mileage": 0,
  "status": "IDLE"
}

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}

3. 车辆详情

请求信息

URL: /approve/vehicle/detail
Method: GET

请求参数（Query String）

参数名	类型	必填	说明
id	Long	是	车辆ID

请求示例

GET /approve/vehicle/detail?id=1

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1,
    "plateNumber": "京A12345",
    "mileage": 52000.00,
    "status": "IN_USE",
    "deleted": 0,
    "createUser": 1,
    "createTime": "2026-05-28 10:00:00",
    "updateUser": 1,
    "updateTime": "2026-05-28 10:00:00",
    "deptId": 100
  }
}

4. 修改车辆

请求信息

URL: /approve/vehicle/update
Method: POST
Content-Type: application/json

请求体参数

参数名	类型	必填	说明
id	Long	是	车辆ID
plateNumber	String	否	车牌号
mileage	Number	否	车辆公里数
status	String	否	使用状态

请求示例

{
  "id": 1,
  "plateNumber": "京A12345",
  "mileage": 52000.00,
  "status": "IN_USE"
}

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}

5. 删除车辆

请求信息

URL: /approve/vehicle/delete
Method: DELETE
Content-Type: application/json

请求体参数

参数名	类型	必填	说明
ids	Array	是	车辆ID数组

请求示例

[1, 2, 3]

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}