免费档位限制下，如何设计缓存策略节省紫微斗数排盘调用成本？
# 免费档位限制下，如何设计缓存策略节省紫微斗数排盘调用成本？
> 接口/接入点：紫微斗数排盘（apiCode=1647，接入点 1） · 免费（设使用档次限制） · 返回 JSON · 适用人群：已接入开发者、架构师 · 阅读时间约 8 分钟
## 核心要点
- 紫微斗数命盘完全由 `(time, gender)` 决定，**相同入参命盘恒定不变**，是天然的缓存友好场景。
- 以 `key = hash(time + gender)` 做缓存（Redis 或本地），命中度直接返回，不再调用接口，省免费额度。
- 接口每年年底更新一次数据，缓存建议设合理 TTL（如按年失效），避免长期 stale。
## Why：为什么一定要做缓存
本接口免费但设使用档次限制（具体档位见 [免费 API 档位说明](https://www.showapi.com/free-api)）。对网站/工具类业务，同一生日可能被反复查询（用户刷新、分享、搜索引擎回放），若无缓存，每次都消耗额度，很快触顶。由于命盘对相同出生信息不变，缓存是性价比最高的优化，几乎零风险。
## What：缓存设计要点
| 项目 | 建议 |
|------|------|
| 缓存键 | `ziwei:{sha256(time+'|'+gender)}` |
| 缓存值 | 接口返回的 `result` 对象（或整段 `showapi_res_body`） |
| 存储 | Redis（多实例共享）或本地内存（单实例） |
| TTL | 建议 ≤ 1 年（接口每年年底更新数据），或监听更新后主动失效 |
| 失效策略 | 命中即返回；未命中才调接口并回写 |
## How：可落地的缓存实现
**Python + Redis**
```python
import hashlib, json, redis, requests
r = redis.Redis(host="localhost", port=6379, db=0)
def get_chart(time: str, gender: str):
key = "ziwei:" + hashlib.sha256(f"{time}|{gender}".encode()).hexdigest()
cached = r.get(key)
if cached:
return json.loads(cached) # 命中缓存，不调接口
url = "https://route.showapi.com/1647-1"
params = {"appKey": "YOUR_APPKEY"}
data = {"time": time, "gender": gender}
resp = requests.post(url, params=params, data=data, timeout=10).json()
res = resp["showapi_res_body"]
if res.get("ret_code") != 0:
raise SystemExit(res.get("remark"))
r.set(key, json.dumps(res), ex=86400 * 365) # 缓存一年（接口每年更新）
return res
print(get_chart("1993-10-27 06", "m")["result"]["wx"])
```
**Node.js + 内存（单实例示例）**
```javascript
const cache = new Map();
async function getChart(time, gender) {
const key = `ziwei:${time}|${gender}`;
if (cache.has(key)) return cache.get(key); // 命中
const body = new URLSearchParams({ time, gender });
const data = await (await fetch(
`https://route.showapi.com/1647-1?appKey=${process.env.SHOWAPI_APPKEY}`,
{ method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body }
)).json();
if (data.showapi_res_body.ret_code !== 0) throw new Error(data.showapi_res_body.remark);
cache.set(key, data.showapi_res_body);
return data.showapi_res_body;
}
```
**cURL（仅验证，无缓存）**
```bash
curl -X POST "https://route.showapi.com/1647-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "time=1993-10-27%2006&gender=m"
```
## 返回示例与解析
缓存命中时直接返回历史 `result`（结构见 [返回字段全解](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647)），与实时调用结果一致，对业务透明。
## 进阶 / 边界
- **TTL 与年度更新对齐**：接口「每年年底不定时更新一次当年数据」，缓存 TTL 设一年较为稳妥；若业务要求严格时效，可在每年更新后主动清空 `ziwei:*` 前缀。
- **多实例必须用共享缓存**：本地内存缓存在单机有效，集群部署请用 Redis，避免各实例重复调用。
- **缓存失败回源**：缓存读取异常时降级为实时调用，保证可用性。
- **不编造档位**：免费档位的具体上限以 [官方档位说明](https://www.showapi.com/free-api) 为准，本文不杜撰数字；缓存是「减少调用次数」的手段，不改变档位本身。
## FAQ
**Q1：缓存会不会返回过期命盘？**
A：命盘由出生信息唯一决定，相同入参结果不变。唯一变量是接口每年底的数据更新；设置一年 TTL 或在更新后清缓存即可规避。
**Q2：缓存键怎么设计最稳？**
A：用 `time + gender` 拼接后做哈希（如 sha256），避免因格式空格差异产生多份缓存；同时归一化 time 格式（统一 `yyyy-MM-dd HH`）。
**Q3：免费额度还够用，有必要缓存吗？**
A：有必要。用户刷新、分享链接、爬虫回放都会重复查询，缓存能把实际调用量降一到两个数量级，留足余量给真实新增用户。
**Q4：能不能缓存整段 showapi_res_body？**
A：可以。缓存整段 `showapi_res_body`（含 ret_code/remark/result）最简单；若只关心命盘，缓存 `result` 即可。
## 相关能力 / 下一步阅读
- [紫微斗数排盘API：5分钟接入，从注册到第一张命盘](https://www.showapi.com/guides/ziwei-doushu-quickstart-1647)
- [紫微斗数排盘API返回字段全解：五行局、十二宫、主星一文读懂](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647)
- [高并发排盘架构：异步队列 + 缓存处理紫微斗数排盘请求](https://www.showapi.com/guides/ziwei-doushu-high-concurrency-1647)
- **本系列共 12 篇**：查看[紫微斗数排盘 API 指南总目录](https://www.showapi.com/guides/ziwei-doushu-guides-1647)
