今日油价开发指南总目录
约 9 分钟 入门今日油价开发指南目录免费接口
# 今日油价开发指南总目录
接口：今日油价（apiCode=138，万维易源 / ShowAPI） · 免费服务 · 覆盖全国 31 个省级行政区 · 2 个接入点 · 最后实测核对：2026-09-18
今日油价（apiCode=138）提供全国 31 个省级行政区的汽油与柴油价格，数据依据国家公布价格每日同步。接口下有两个接入点：查询油价（138-46）按省名查具体标号价格，`prov` 选填、不传时一次返回全部 31 个省级行政区；查询行情（138-49）查涨跌幅与调价日，`prov` 必填。本目录汇总全部 13 篇开发指南，按入门、场景实战、技术深挖、行业方案、工具链集成五个层次组织。
## 入门
1. [今日油价：用 Python 查北京 92 号汽油价格的完整调用流程](https://www.showapi.com/guides/oilprice-quickstart-138) — 注册拿 AppKey，三段可直接运行的代码跑通第一次调用，含实测返回。
2. [今日油价 prov 参数怎么传？查询油价与查询行情的必填差异](https://www.showapi.com/guides/oilprice-prov-param-138) — 两个接入点的必填规则、省名匹配行为与缺失时的返回层级。
3. [今日油价返回字段对照：p89/p92/p0 与 ct 的含义与空值处理](https://www.showapi.com/guides/oilprice-fields-138) — 两个接入点的字段表、空值分布实测，以及同名 `p0` 的类型差异。
4. [今日油价标号对照：89/92/95/98 汽油与 0 号柴油的字段映射](https://www.showapi.com/guides/oilprice-grade-meaning-138) — 字段与油品标号的对应关系，现行标号与历史标号的展示取舍。
## 场景实战
5. [今日油价涨跌幅怎么查？查询行情接入点的调价日与涨跌率用法](https://www.showapi.com/guides/oilprice-trend-138) — 查询行情（138-49）的 8 个标号涨跌对象、调价日解析与倒计时。
6. [今日油价：一次调用取回全国 31 省油价的做法](https://www.showapi.com/guides/oilprice-province-list-138) — 不传 `prov` 的全量用法、31 个省级行政区名单与全国比价代码。
7. [今日油价数据什么时候刷新？用 ct 字段判断缓存是否过期](https://www.showapi.com/guides/oilprice-schedule-138) — 按 `ct` 变化判断数据是否换批，以及调价窗口前主动刷新。
## 技术深挖
8. [今日油价调用量规划：缓存粒度与 TTL 的确定方式](https://www.showapi.com/guides/oilprice-cache-138) — 档位对照表、缓存粒度的对照实测与 Redis 实现。
9. [在车主服务 APP 里接入今日油价的完整流程](https://www.showapi.com/guides/oilprice-app-integration-138) — 后端代理、全量快照缓存与前端卡片渲染的落地代码。
10. [今日油价 MCP 服务：在 Cherry Studio 里用中文工具名查询](https://www.showapi.com/guides/oilprice-mcp-138) — 接口级 MCP 配置、中文工具名、握手顺序与返回内容实测。
## 行业方案
11. [今日油价：公众号与小程序怎么加油价查询？省份选择与卡片展示](https://www.showapi.com/guides/oilprice-wechat-miniapp-138) — 云函数代理、省份 picker 与卡片组件的完整实现。
12. [今日油价：客服工作台的查价面板与调价提醒话术](https://www.showapi.com/guides/oilprice-cs-empower-138) — 坐席查价文案与调价提醒模板，含实测话术样例。
## 工具链集成
13. [今日油价 OpenAPI 3.0 文档：导入 Postman 与 Swagger UI 调试](https://www.showapi.com/guides/oilprice-openapi-138) — 文档结构核对、工具导入步骤与用文档驱动代码封装的写法。
## 相关资源
| 资源 | 链接 |
|---|---|
| 接口详情页（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 |
| 接口使用向导 | https://www.showapi.com/apiGateway/view/138?tab=guides |
| OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/138.yaml |
| OpenAPI 文档（JSON） | https://www.showapi.com/openapi/market/138.json |
| MCP 服务 | http://www.showapi.com.cn/mcp/138/{appKey} |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费接口与档位说明 | https://www.showapi.com/free-api |
| 多语言示例 | https://www.showapi.com/apitest/market/138/46 |
## 阅读建议
- 第一次接入：从第 1 篇开始，跑通调用后再看第 3 篇的字段对照。
- 要查具体价格：看查询油价（138-46）相关的第 1、3、4、6 篇。
- 要做涨跌与调价提醒：看查询行情（138-49）相关的第 5、7、12 篇。
- 上线前：把第 8、9 篇的缓存与代理做一遍，再确认档位额度。
- AI 客户端集成：走第 10 篇的 MCP 配置，或用第 13 篇的 OpenAPI 文档接入工具链。
## FAQ
**Q1：今日油价有两个接入点，我该用哪个？**
要具体标号的当前价格用查询油价（138-46），要涨跌幅和调价日用查询行情（138-49）。两者的 `prov` 必填规则不同，前者选填、后者必填。
**Q2：这个接口收费吗？**
免费服务，注册后默认可调用，按平台档位限制调用量。档位与积分规则见 https://www.showapi.com/free-api
**Q3：数据多久更新一次？**
产品说明的口径是依据国家公布价格每日同步。2026-09-18 实测返回的 `ct` 字段值为 `2026-09-18 12:00:05.916`，可作为该批数据生成时间的参照，判断数据是否换批直接比较 `ct` 是否变化更可靠。
**Q4：一次调用能拿到几个省的数据？**
查询油价（138-46）不传 `prov` 时返回全部 31 个省级行政区，2026-09-18 实测返回 31 条、`showapi_fee_num=1`；传 `prov` 则只返回该省 1 条。
**Q5：这些指南里的价格数据可以直接对外用吗？**
指南中的价格来自 2026-09-18 的实测记录，只用于说明返回结构，不代表实时行情。产品里展示的价格请以接口实时返回为准。
## 实测说明
本系列所有字段、状态码、计费行为与返回示例均来自 2026-09-18 的真实调用记录，涉及价格的具体数值以该次实测量为准，不代表实时行情。接入后请以接口实际返回为准。
