# 【新增·管理后台】车型大类全量列表(不分页) GET /admin/fleet/vehicle-types/list

> 存放目录: changelogs-v2/2026-06/
> 涉及服务: hl-fleet-service(8087)
> PR: #3654(已合并 dev-v3,**测试服已部署并 API 实测通过**) | 无关联工单(wx 2026-06-10 提出) | 日期: 2026-06-10
> 影响范围: 管理后台车型下拉/筛选场景(新接口,纯增量)

## ⚠️ 关键说明

下拉/筛选要全量大类时不用再调分页接口拼页了:新接口一次返回**全部大类**(不分页、不含 models 数组),单条结构与 `GET /admin/fleet/vehicle-types/page` 的 records **完全一致**(含 `modelCount`/`inUseCount` 计数),按 sort_order 升序。

- 要型号树 → 用 `GET /admin/fleet/vehicle-types`(§1.1,大类+models 全量);
- 要分页检索大类 → 用 `/page`(§1.5);
- 只要大类轻量全量(下拉) → **用本接口**。

## 1. 接口定义

`GET /admin/fleet/vehicle-types/list` —— 入参:无

**响应示例**(测试服实测):

```json
{
  "code": 200,
  "data": [
    { "id": "1929151481086734337", "typeKey": "suv2", "typeName": "SUV 越野", "icon": "🚙",
      "description": "高底盘 / 沙漠越野", "sortOrder": 1, "modelCount": 1, "inUseCount": 0 },
    { "id": "1930561885327036417", "typeKey": "mpv", "typeName": "MPV 商务", "icon": "🚐",
      "description": "", "sortOrder": 2, "modelCount": 0, "inUseCount": 0 }
  ],
  "message": "成功"
}
```

## 2. 文档

FLEET API → **v1.5.52** 新增 §1.7 小节(§1 章 10 端点),文档站已同步:https://web.test.1814.love:9443/hl-docs/order-v3/api/API-SPEC-FLEET-V1.5.html