今日油价：导入 Apifox / Postman，用 OpenAPI 文档管理你的接口
# 今日油价：导入 Apifox / Postman，用 OpenAPI 文档管理你的接口
> 接口/接入点：今日油价（apiCode 138，接口级 OpenAPI 3.0） · 免费 · 适用人群：注重 API 治理的团队 · 阅读时间：约 5 分钟
## TL;DR
- 今日油价提供**接口级 OpenAPI 3.0 文档**，覆盖查询油价、查询行情全部接入点。
- 下载 YAML 导入 Apifox / Postman / Swagger UI，自动生成请求模板和 Mock 数据。
- 文档地址：`https://www.showapi.com/openapi/market/138.yaml`（同 `.json`）。
## Why
团队接多个接口时，统一的 OpenAPI 文档能省下大量手写请求模板、做契约测试、生成 Mock 的工作量。今日油价的 OpenAPI 文档一次导入，两个接入点的请求/响应结构就都有了。
## What
| 项 | 说明 |
|----|------|
| 文档格式 | OpenAPI 3.0 |
| 覆盖范围 | 全部接入点（138-46、138-49） |
| 在线查看 | `https://www.showapi.com/openapi/market/138.yaml` |
| 下载 | 同上 YAML / `https://www.showapi.com/openapi/market/138.json` |
## How
**步骤 1：下载文档**
```bash
curl -O "https://www.showapi.com/openapi/market/138.yaml"
```
**步骤 2：导入工具**
- **Apifox**：项目内「导入」→ 选择 `138.yaml` → 自动生成接口与 Mock。
- **Postman**：Import → 选 YAML/JSON → 生成 Collection。
- **Swagger UI**：`File → Import URL` 填上述地址即可可视化。
**步骤 3：用生成模板发请求**
导入后，每个接入点已有预填的请求地址与参数（`prov` 等），填 AppKey 即可调试。等价于直接打：
```bash
curl -X POST "https://route.showapi.com/138-46?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" -d "prov=%E5%8C%97%E4%BA%AC"
```
## 返回示例与解析
OpenAPI 文档的响应 schema 与线上返回一致；字段含义对照见[《今日油价返回字段全解》](https://www.showapi.com/guides/oilprice-fields-138)。
## 进阶/边界
- **接口级文档**：一份 `138.yaml` 覆盖全部接入点，无需分别管理。
- **与 MCP 二选一或并存**：偏好标准文档治理用 OpenAPI；偏好自然语言调用用 [MCP](https://www.showapi.com/guides/oilprice-mcp-138)。
- **AppKey 管理**：统一在控制台「我的 App」维护，见 <https://www.showapi.com/console#/myApp>。
## FAQ
**Q：OpenAPI 文档覆盖两个接入点吗？**
A：覆盖，接口级文档 `138.yaml` 包含查询油价（138-46）与查询行情（138-49）。
**Q：没有 Apifox 能用吗？**
A：可以，Postman、Swagger UI 均支持 OpenAPI 3.0 导入。
**Q：文档会过期吗？**
A：以官方发布为准；接入点结构变动请重新下载最新 YAML。
## 相关能力 / 下一步阅读
- [今日油价：通过 MCP 协议在 Cherry Studio / ChatBox 中直接查询](https://www.showapi.com/guides/oilprice-mcp-138)
- [今日油价返回字段全解：p89/p90/p0/p92/p93/p95/p97/p98 与 ct 一文读懂](https://www.showapi.com/guides/oilprice-fields-138)
- **本系列共 13 篇**：查看[今日油价开发指南总目录](https://www.showapi.com/guides/oilprice-guides-138)
