车型大全返回字段全解：品牌/车系/车型详情三层结构一文读懂
# 车型大全返回字段全解：品牌/车系/车型详情三层结构一文读懂
> 接口/接入点：车型大全（apiCode 1467）· 全部 3 个接入点 · 免费 · POST/GET · JSON · 适用人群：所有开发者 · 阅读时间：约 8 分钟
## 核心要点
- 车型大全三个接入点返回结构逐级变深：品牌查询最浅（品牌数组），车系查询多一层（车系+车型），车型详情最深（十几类配置对象）。
- 所有返回都包在 `showapi_res_body` 内；`ret_code == "0"` 表示成功，其他为失败。
- 车型详情的配置项用 `●`/`○`/`-` 标记（标配/选装/无），`nev` 标识是否新能源，是比价、选车场景的关键字段。
## Why
三个接入点的字段长得不一样，刚上手很容易把"车系"和"车型"搞混，或拿到车型详情那一长串 `fdj`、`bsx` 配置对象后不知道怎么读。这篇把所有结构一次讲清，并附一份配置对象速查词典，后续文章都引用它。
## What
| 接入点 | 地址 | 入参 | 核心返回 |
|--------|------|------|----------|
| 品牌查询 1467-1 | route.showapi.com/1467-1 | 无业务参数 | `data[]`: initial, brand_id, brand |
| 车系查询 1467-2 | route.showapi.com/1467-2 | brandName / brandId（选填） | `data[]`: series, series_id, model, model_id, initial, brand_id, brand |
| 车型详情 1467-3 | route.showapi.com/1467-3 | brandId+serieId（必填）, page/maxResults/modelId（选填） | 顶层车型字段 + `data[]` 嵌套配置对象 |
公共返回：`showapi_res_code`、`showapi_res_error`、`showapi_res_id` 为系统级字段；业务数据都在 `showapi_res_body`。
## How
### 三个接入点的返回逐层对照
```json
// 1467-1 品牌查询
{ "showapi_res_body": { "ret_code":"0", "msg":"查询成功",
"data": [ { "initial":"A", "brand_id":"59bf445f3909f3a96b69eb7e", "brand":"奥迪" } ] } }
// 1467-2 车系查询
{ "showapi_res_body": { "ret_code":"0", "msg":"查询成功！",
"data": [ { "series":"一汽-大众奥迪", "series_id":"...", "model":"奥迪A3两厢", "model_id":"...", "initial":"A", "brand_id":"...", "brand":"奥迪" } ] } }
// 1467-3 车型详情（节选）
{ "showapi_res_body": { "ret_code":"0", "count":51, "page":1, "maxResult":1,
"car_initial":"A", "car_brand":"奥迪", "car_series":"Audi Sport", "car_model":"奥迪R8",
"model_id":"...", "mod_type":"2021款 V10 Coupe Performance", "nev":"0",
"data": [ { "fdj":{...}, "bsx":{...}, "dpzx":{...}, "ckpz":{...}, "aqpz":{...}, "...":{} } ] } }
```
### 车型详情配置对象速查词典
| 对象键 | 含义 | 典型子字段 |
|--------|------|-----------|
| `fdj` | 发动机 | 燃油标号 `rybh`、排量 `plL`、马力 `zdmlPs`、扭矩 `zdnjNmrpm`、气缸排列 `qgplxs` |
| `bsx` | 变速箱 | 类型 `bsxlx`、挡位数 `dwgs` |
| `dpzx` | 底盘/转向 | 驱动方式 `sqxs`、悬挂 `qxglx`/`hxglx`、助力类型 `zllx` |
| `clzd` | 车轮/制动 | 前/后制动 `qzdqlx`/`hzdqlx`、轮胎规格 `qltgg`/`hltgg` |
| `cscs` | 车身尺寸 | 长/宽/高 `ccmm`/`ckmm`/`cgmm`、轴距 `zjmm`、座位数 `zws`、车身结构 `csjg` |
| `jbcs` | 基本参数 | 上市年份 `ssnf`、指导价 `cszdj`、工信部油耗 `gxbyhLkm`、整车质保 `zczbzc` |
| `ckpz` | 操控配置 | ABS `ABSfbs`、ESP `cswdkzESPESCd`、制动辅助 `zdlfpEBDCBCd` |
| `aqpz` | 安全配置 | 气囊 `cqn`、胎压监测 `tyjczz`、并线辅助 `pljsts` |
| `dmtpz` | 多媒体 | 音响品牌 `yxpp`、扬声器 `ysqsl`、中控屏 `czdhxt` |
| `nbpz` / `wbpz` / `zypz` / `blhsj` / `dgpz` / `kdbx` / `xzb` | 内部/外部/座椅/玻璃后视镜/灯光/空调冰箱/悬挂其他配置 | 各配置项以 `●`/`○`/`-` 标记 |
标记含义：`●` 标配、`○` 选装、`-` 无或未提供。`nev`：`"1"` 新能源，`"0"` 非新能源。
## 返回示例与解析
完整车型详情返回见《车型大全车型详情字段拆解》一文，本文重点在结构对照与词典。注意 `data[]` 里每一个元素是一辆具体"车型款型"的配置集合，`mod_type` 是款型名（如"2021款 V10 Coupe Performance"）。
## 进阶/边界
- 品牌查询无分页参数，一次返回全部品牌；车系查询返回某品牌下所有车系与车型，数据量大时建议在本地落库。
- 车型详情标"每周六早上 3 点更新"，非实时，做价格/配置展示时要提示数据时效（见《数据更新机制》）。
- 配置对象键名为拼音缩写（如 `fdj`、`bsx`），含义以官方帮助手册为准，本文词典为常用项速查。
## FAQ
**Q: data 和顶层字段（如 car_brand）有什么区别？**
顶层的 `car_brand`/`car_series`/`car_model` 是当前查询维度的摘要；`data[]` 才是具体款型的完整配置集合，真正要展示细节时读 `data[]`。
**Q: 配置项里的 ● ○ - 是什么意思？**
`●` 标配、`○` 选装、`-` 无或未提供，是厂商配置表的通用标记。
**Q: nev 字段怎么用？**
`nev` 为 `"1"` 表示新能源，`"0"` 表示非新能源，可用于新能源车筛选。
## 相关能力 / 下一步阅读
- [车型大全车型详情字段拆解：发动机/变速箱/底盘/安全配置怎么读](https://www.showapi.com/guides/car-model-detail-explain-1467)
- [车型大全三级联动查询实战：品牌→车系→车型详情全链路设计](https://www.showapi.com/guides/car-model-chain-query-1467)
- **本系列共 12 篇**：查看[车型大全 API 指南总目录](https://www.showapi.com/guides/car-model-guides-1467)
