38 行
1.6 KiB
Markdown
38 行
1.6 KiB
Markdown
# 【新增·管理后台】车型大类全量列表(不分页) 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
|