今日油价：免费也有档次限制，如何设计缓存避免超限？
# 今日油价：免费也有档次限制，如何设计缓存避免超限？
> 接口/接入点：今日油价 · 查询油价（138-46）/ 查询行情（138-49） · 免费 · 适用人群：中高级开发者、架构师 · 阅读时间：约 7 分钟
## TL;DR
- 今日油价**免费**，但注册默认档位有限，高频实时调用会触发使用档次限制。
- 数据每日 7 点更新，**缓存 TTL 设为当天 7 点后过期**最划算：每天最多查一次/省。
- 用 Redis 按 `prov` 做 key，命中即返缓存，未命中才打接口并写回。
## Why
免费 ≠ 无限。今日油价设了使用档次（防滥用），默认档位对试用够用，但一旦上线到车主 APP、被大量用户频繁刷新，实时调用很快就撞档位红线，导致接口被限。油价每天只变一次，完全没必要每次实时查——缓存是必须的工程动作，既省钱（调用档位）又提速。
## What
| 项 | 说明 |
|----|------|
| 计费 | 免费，有使用档次限制（积分可兑更高档） |
| 更新频率 | 每日 7 点 |
| 缓存目标 | 减少调用、避免超档、提升响应 |
## How
**步骤：查缓存 → 命中返回 → 未命中查接口并写回（TTL 对齐 7 点）**
```python
import requests, redis, datetime
rds = redis.Redis(host="localhost", port=6379, db=0)
def next_7am():
now = datetime.datetime.now()
d = now.replace(hour=7, minute=0, second=0, microsecond=0)
if now >= d:
d += datetime.timedelta(days=1)
return int((d - now).total_seconds())
def get_oil_price(prov):
key = f"oil:{prov}"
cached = rds.get(key)
if cached:
return cached.decode() # 命中
resp = requests.post("https://route.showapi.com/138-46",
data={"appKey": "YOUR_APPKEY", "prov": prov},
timeout=10).json()
body = resp.get("showapi_res_body", {})
if body.get("ret_code") != 0:
return None
item = body["list"][0]
val = str(item)
rds.setex(key, next_7am(), val) # TTL 到下次 7 点
return val
```
cURL（缓存未命中时由服务端触发）：
```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"
```
Node.js（fetch + 伪缓存示意）：
```javascript
const cache = new Map();
async function getOil(prov) {
if (cache.has(prov)) return cache.get(prov);
const r = await fetch("https://route.showapi.com/138-46", {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({ appKey: "YOUR_APPKEY", prov }),
});
const item = (await r.json()).showapi_res_body.list[0];
cache.set(prov, item); // 生产用 Redis + TTL
return item;
}
```
## 返回示例与解析
缓存 key 设计为 `oil:{prov}`，value 存整个 `list[0]` 对象（JSON）。TTL 用「距下次 7 点的秒数」，保证每天最多回源一次。
## 进阶/边界
- **为什么 TTL 对齐 7 点**：数据每日 7 点更新，缓存到下次 7 点过期，既不取旧数据也不浪费调用。
- **调价日主动失效**：若接入「查询行情」的 `next_change_time`，可在临近调价时主动删 key 强制回源（见[《今日油价：如何避免取到旧数据？》](https://www.showapi.com/guides/oilprice-schedule-138)）。
- **批量拉全也要缓存**：全国 31 省一次性拉全同样走缓存，别每次实时 31 次（见[《全国 31 省油价怎么一次性拉全？》](https://www.showapi.com/guides/oilprice-province-list-138)）。
## FAQ
**Q：免费接口为什么要缓存？**
A：免费但有使用档次限制，高频实时调用会超限导致被限流；油价每天只更新一次，缓存既能省调用又能提速。
**Q：缓存多久过期合适？**
A：TTL 设为「距当天/次日 7 点的剩余秒数」，每天最多回源一次。
**Q：缓存会不会拿到昨天的旧价？**
A：不会——TTL 到 7 点即过期回源，正好对齐数据更新时间。
## 相关能力 / 下一步阅读
- [今日油价：如何避免取到旧数据？结合每日 7 点更新频率的定时拉取](https://www.showapi.com/guides/oilprice-schedule-138)
- [今日油价：全国 31 省油价怎么一次性拉全？省份枚举与批量设计](https://www.showapi.com/guides/oilprice-province-list-138)
- **本系列共 13 篇**：查看[今日油价开发指南总目录](https://www.showapi.com/guides/oilprice-guides-138)
