车型大全 OpenAPI 导入：用 Postman / Swagger UI 管理接口文档
# 车型大全 OpenAPI 导入：用 Postman / Swagger UI 管理接口文档
> 接口/接入点：车型大全（apiCode 1467）· OpenAPI 3.0 文档（覆盖全部接入点）· 免费 · 适用人群：API 治理团队、开发者 · 阅读时间：约 5 分钟
## 核心要点
- 车型大全提供标准 OpenAPI 3.0 文档，覆盖全部接入点，可导入 Postman / Swagger UI / Swagger Editor，或供 AI Agent 直接消费。
- 文档地址：[YAML](https://www.showapi.com/openapi/market/1467.yaml) · [JSON](https://www.showapi.com/openapi/market/1467.json)。
- 用 OpenAPI 文档可以自动生成请求模板与 Mock 数据，方便团队协作与接口治理；本文不依赖任何第三方闭源工具。
## Why
当接口要在团队里复用、要做 Mock、要接 CI 或让 AI 消费时，一份标准 OpenAPI 文档比"口口相传"靠谱得多。车型大全已经把文档生成好了，你只要下载并导入你习惯的工具即可。本文演示用 Postman / Swagger UI 管理它。
## What
| 项 | 说明 |
|----|------|
| 文档格式 | OpenAPI 3.0 |
| 覆盖范围 | 车型大全全部接入点（1467-1 / 1467-2 / 1467-3） |
| YAML 地址 | https://www.showapi.com/openapi/market/1467.yaml |
| JSON 地址 | https://www.showapi.com/openapi/market/1467.json |
| 适用工具 | Postman / Swagger UI / Swagger Editor（及兼容 OpenAPI 的任意工具） |
## How
### 方式一：导入 Postman
1. 打开 Postman → 左上角 `Import`。
2. 选择 `Link` 方式，粘贴 `https://www.showapi.com/openapi/market/1467.yaml`，或下载 YAML 后选 `File` 导入。
3. 导入后自动生成各接入点的请求集合；在 `appKey` 参数处填入你的 AppKey 即可发送。
### 方式二：用 Swagger UI / Swagger Editor 预览与调试
1. 打开 Swagger Editor（或任意 Swagger UI 实例）→ `File` → `Import URL`。
2. 粘贴 `https://www.showapi.com/openapi/market/1467.yaml`。
3. 文档会渲染出三个接入点的参数与示例，可直接在界面里填参调试，也能一键导出 Mock Server 配置。
### 方式三：供 AI Agent 消费
OpenAPI 3.0 是机器可读契约，可直接交给支持 OpenAPI 的 AI 工具/Agent 作为工具描述，让它自动理解参数与返回结构（与 MCP 互补，MCP 见《通过 MCP 在 AI 客户端直接查询》）。
## 返回示例与解析
导入后，每个接入点的 `parameters`（如 `brandId`、`serieId`）与 `responses` 中的 `showapi_res_body` 结构都会展示出来，与本文档系列《返回字段全解》一一对应，可作为团队统一的字段事实来源。
## 进阶/边界
- 文档以官方源为准，若接口更新，重新导入最新 YAML/JSON 即可，不要手工维护副本。
- 导入后建议把 AppKey 放进环境变量，避免硬编码进共享集合。
- 本文只使用 Postman / Swagger UI / Swagger Editor 等通用工具，不依赖任何闭源/受限工具。
## FAQ
**Q: OpenAPI 文档和 MCP 有什么区别？**
OpenAPI 是静态接口契约，适合文档、Mock、代码生成与治理；MCP 是让 AI 客户端动态调用协议的集成方式，两者互补。
**Q: 导入后 appKey 填在哪？**
`appKey` 是 query 参数，在生成的请求里填到对应参数位置（建议用环境变量管理，勿硬编码）。
**Q: 文档会包含所有接入点吗？**
会。官方 OpenAPI 3.0 文档覆盖车型大全全部接入点（1467-1/2/3）。
## 相关能力 / 下一步阅读
- [车型大全通过 MCP 在 AI 客户端直接查询：Cherry Studio / ChatBox 配置](https://www.showapi.com/guides/car-model-mcp-integration-1467)
- [车型大全返回字段全解：品牌/车系/车型详情三层结构一文读懂](https://www.showapi.com/guides/car-model-response-fields-1467)
- **本系列共 12 篇**：查看[车型大全 API 指南总目录](https://www.showapi.com/guides/car-model-guides-1467)
