# 今日油价开发指南总目录
> 接口：今日油价（apiCode 138，万维易源/ShowAPI） · 免费 · 全国 31 省油价查询 · 数据每日 7 点更新
今日油价提供全国 31 个省份的汽油/柴油具体价格，数据根据国家公布价格每日凌晨 7 点同步；含两个接入点——**查询油价**（按省名查具体标号价格）与**查询行情**（查涨跌幅与调价日）。本目录汇总全部 13 篇开发指南，覆盖入门、场景实战、技术深挖、行业方案与生态集成。
## 入门层
1. [今日油价：5 分钟接入，从注册到查到北京 92 号汽油价格](https://www.showapi.com/guides/oilprice-quickstart-138) — 注册拿 AppKey，三段可直接运行的代码跑通第一次调用。
2. [今日油价返回字段全解：p89/p90/p0/p92/p93/p95/p97/p98 与 ct 一文读懂](https://www.showapi.com/guides/oilprice-fields-138) — 字段对照表 + 汽油/柴油标号分类，空字符串含义。
## 场景实战层
3. [今日油价：车主服务 APP 如何集成？从加油页到实时油价卡片的全链路设计](https://www.showapi.com/guides/oilprice-app-integration-138) — 后端代理 + 前端卡片代码骨架。
4. [今日油价：涨跌幅怎么查？「查询行情」接入点的调价日与涨跌率实战](https://www.showapi.com/guides/oilprice-trend-138) — 138-49 接入点的 p0 涨跌幅与下次调价日。
5. [今日油价：prov 参数填不填？查询油价(选填) vs 查询行情(必填) 的正确姿势](https://www.showapi.com/guides/oilprice-prov-param-138) — 两接入点必填规则差异避坑。
6. [今日油价：全国 31 省油价怎么一次性拉全？省份枚举与批量设计](https://www.showapi.com/guides/oilprice-province-list-138) — 省名清单 + 限速批量拉取骨架。
## 技术深挖层
7. [今日油价：免费也有档次限制，如何设计缓存避免超限？](https://www.showapi.com/guides/oilprice-cache-138) — Redis 缓存 + TTL 对齐每日 7 点。
8. [今日油价：89/92/95/98 与 90/93/97 有什么区别？标号含义科普](https://www.showapi.com/guides/oilprice-grade-meaning-138) — 现行国六标号 vs 历史标号，p0 是柴油。
9. [今日油价：如何避免取到旧数据？结合每日 7 点更新频率的定时拉取](https://www.showapi.com/guides/oilprice-schedule-138) — 缓存过期点对齐更新点 + 调价日主动失效。
## 行业方案层
10. [今日油价：公众号/小程序油价查询方案，菜单触发+省份选择+卡片展示](https://www.showapi.com/guides/oilprice-wechat-miniapp-138) — 微信生态内嵌查询方案。
11. [今日油价：加油/养车类客服系统赋能，一键查油价、自动答复调价](https://www.showapi.com/guides/oilprice-cs-empower-138) — 客服工作台嵌入 + 调价提醒话术。
## 生态集成层
12. [今日油价：通过 MCP 协议在 Cherry Studio / ChatBox 中直接查询](https://www.showapi.com/guides/oilprice-mcp-138) — 接口级 MCP 配置，AI 客户端直接查。
13. [今日油价：导入 Apifox / Postman，用 OpenAPI 文档管理你的接口](https://www.showapi.com/guides/oilprice-openapi-138) — OpenAPI 3.0 导入工具链。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=138） | <https://www.showapi.com/apiGateway/view/138> |
| 接入点：查询油价（138-46） | <https://www.showapi.com/apiGateway/view/138/46> |
| 接入点：查询行情（138-49） | <https://www.showapi.com/apiGateway/view/138/49> |
| OpenAPI 文档（YAML） | <https://www.showapi.com/openapi/market/138.yaml> |
| OpenAPI 文档（JSON） | <https://www.showapi.com/openapi/market/138.json> |
| AppKey 管理 | <https://www.showapi.com/console#/myApp> |
| 调用帮助 | <https://www.showapi.com/helpcenter/view#/3960/1> |
| 多语言示例 | <https://www.showapi.com/apitest/market/138/46> |
## 阅读建议
- **第一次接**：从「5 分钟接入」开始，再读「返回字段全解」。
- **做功能**：查具体价格看查询油价（138-46）相关文章；查涨跌幅/调价日看「涨跌幅怎么查」。
- **上线前**：务必读「缓存避免超限」与「定时拉取」，处理好免费档位与每日 7 点更新。
- **AI 集成**：用 MCP 或 OpenAPI 文档把油价接进你的工具链。
