【新增·管理后台】车型大类全量列表(不分页) 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 —— 入参:无

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

{
  "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

1.6 KiB 原始文件 永久链接 Blame 文件历史

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

⚠️ 关键说明

1. 接口定义

2. 文档

1.6 KiB

原始文件永久链接 Blame 文件历史