# 车型大全：5 分钟接入，从注册到第一条品牌列表
> 接口/接入点：车型大全（apiCode 1467）· 品牌查询 1467-1 · 免费 · POST/GET · JSON · 适用人群：新注册用户、初级开发者 · 阅读时间：约 5 分钟
## 核心要点
- 车型大全是万维易源官方自营的免费汽车数据库，注册后默认可调用（设档位限制），无需付费即可拿到约 200 个品牌的列表。
- 第一步只需一个 AppKey，调用品牌查询接入点 1467-1 即可返回全部品牌，无业务参数。
- 所有返回数据都包在 `showapi_res_body` 内，业务数组在 `data[]`，成功标志看 `ret_code == "0"`。
## Why
如果你在做汽车类网站、二手车平台、选车工具，或只是想玩玩车型数据，第一步永远是"先拿到数据"。车型大全把品牌、车系、车型三层数据都开放了，而且注册就免费，非常适合做原型或练手。本文带你用 5 分钟跑通第一次调用，拿到第一条品牌列表。
## What
| 项 | 说明 |
|----|------|
| 接口 | 车型大全 apiCode 1467 |
| 本次接入点 | 品牌查询 1467-1 |
| 请求地址 | https://route.showapi.com/1467-1?appKey=YOUR_APPKEY |
| 请求方式 | POST 或 GET |
| 鉴权 | query 参数 `appKey` |
| 业务参数 | 无（仅需 AppKey） |
| 返回格式 | JSON，业务数据在 `showapi_res_body` |
| 计费 | 免费（设档位限制，见免费 API 说明） |
| 服务商 | 昆明秀派科技有限公司（易源官方自营） |
前置条件：
- 已在 https://www.showapi.com 注册并登录；
- 在 [AppKey 管理](https://www.showapi.com/console#/myApp) 拿到一个 AppKey，替换下方 `YOUR_APPKEY`。
## How
### 步骤 1：调用品牌查询（cURL）
```bash
curl -X POST "https://route.showapi.com/1467-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded"
```
### 步骤 2：用 Python 解析
```python
import requests
APP_KEY = "YOUR_APPKEY"
url = "https://route.showapi.com/1467-1"
resp = requests.post(url, params={"appKey": APP_KEY}, timeout=10)
resp.encoding = "utf-8"
body = resp.json()["showapi_res_body"]
if body.get("ret_code") != "0":
raise RuntimeError("调用失败: " + body.get("msg", ""))
brands = body["data"]
print(f"共 {len(brands)} 个品牌，前 5 个：")
for b in brands[:5]:
print(b["initial"], b["brand_id"], b["brand"])
```
### 步骤 3：用 Node.js 解析
```javascript
const APP_KEY = "YOUR_APPKEY";
const url = `https://route.showapi.com/1467-1?appKey=${APP_KEY}`;
const res = await fetch(url, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
});
const json = await res.json();
const body = json.showapi_res_body;
if (body.ret_code !== "0") throw new Error("调用失败: " + body.msg);
console.log(`共 ${body.data.length} 个品牌`);
console.log(body.data.slice(0, 5).map((b) => `${b.initial} ${b.brand}`).join("\n"));
```
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"ret_code": "0",
"msg": "查询成功",
"data": [
{"initial": "A", "brand_id": "59bf445f3909f3a96b69eb7e", "brand": "奥迪"}
]
}
}
```
字段说明：
- `showapi_res_body.ret_code`：`"0"` 成功，其他失败。
- `showapi_res_body.data[]`：品牌数组，`initial` 首字母、`brand_id` 品牌 Id、`brand` 品牌名。
- `brand_id` 是后续车系查询、车型详情的入参，建议先存下来。
## 进阶/边界
- 品牌查询无业务参数，一次返回全部品牌（文档未提供分页参数），数据量大时可本地缓存，减少重复调用。
- `ret_code` 非 0 时看 `msg` 排查，常见为 AppKey 无效或触发档位限制。
- 免费接口设"使用档次限制"防止滥用，高频实时调用见《车型大全免费调用与档位限制》。
## FAQ
**Q: 品牌查询需要传哪些参数？**
只需 AppKey，没有业务参数。文档未提供品牌查询的分页参数，一次返回全部品牌列表。
**Q: ret_code 返回非 0 怎么办？**
结合 `msg` 字段判断。最常见是 AppKey 无效或触发档位限制；先到 AppKey 管理确认 Key 有效、未欠费或超限。
**Q: 返回里的 brand_id 有什么用？**
`brand_id` 是车系查询（1467-2）的可选入参、车型详情（1467-3）的必填入参，用于定位具体品牌。
## 相关能力 / 下一步阅读
- [车型大全返回字段全解：品牌/车系/车型详情三层结构一文读懂](https://www.showapi.com/guides/car-model-response-fields-1467)
- [车型大全三级联动查询实战：品牌→车系→车型详情全链路设计](https://www.showapi.com/guides/car-model-chain-query-1467)
- **本系列共 12 篇**：查看[车型大全 API 指南总目录](https://www.showapi.com/guides/car-model-guides-1467)
