免费名言警句：如何设计缓存策略，避免重复调用浪费免费档位
# 免费名言警句：如何设计缓存策略，避免重复调用浪费免费档位
> 接口 1839-1 · 免费（有档位限制）· 适用人群：已接入、关注成本与稳定性的开发者 · 阅读时间：约 5 分钟
## 核心要点
- 名言内容更新慢、且接口本身随机返回，**极其适合缓存**，可大幅减少重复调用。
- 用 Redis 存一个"名言池"，定时批量补充，业务侧从本地池取，几乎不依赖实时调用。
- 缓存是应对"免费档位限制"最划算的手段——少调用 = 少占额度。
## Why
免费接口不是无限调用，设有使用档次限制。如果你的网站每次刷新都实时调一次接口，用户量一大额度很快见底，出现"返回为空/限流"。而名言是低时效内容——昨天和今天的名言对用户没差别。把结果缓存起来复用，既能扛住流量，又不浪费额度。本文给出可落地的缓存设计。
## What
**接口速览**
| 项 | 值 |
|----|----|
| 实时性需求 | 低（名言可缓存） |
| 计费 | 免费，有档位限制 |
| 推荐缓存 | 内存（如 Redis）缓存"名言池" + 定时补充 |
## How
### 步骤 1：建立本地"名言池"（Redis）
```python
import redis, requests, random, time
r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
POOL_KEY = "famous_quotes_pool"
REFRESH_AT = "famous_quotes_ts"
def refill():
"""向接口批量取 10 条，写入 Redis 列表；成功才更新时间戳。"""
resp = requests.get(
"https://route.showapi.com/1839-1",
params={"appKey": "YOUR_APPKEY", "num": "10"},
timeout=15,
).json()
body = resp["showapi_res_body"]
if body.get("ret_code") != "0":
raise RuntimeError(body.get("remark"))
items = [it["content"] for it in body["contentlist"]]
if items:
r.delete(POOL_KEY)
r.rpush(POOL_KEY, *items)
r.set(REFRESH_AT, int(time.time()))
def get_one():
# 池空或 1 小时未补充则补充
if r.llen(POOL_KEY) == 0 or (time.time() - int(r.get(REFRESH_AT) or 0) > 3600):
try:
refill()
except Exception as e:
print("补充失败：", e)
item = r.lpop(POOL_KEY) # 取一条并移出，避免重复
return item or "（名言池暂空，请稍后再试）"
```
### 步骤 2：业务侧取用
业务代码直接调 `get_one()`，命中本地池即返回，不触发接口调用；只有池空/到期才回源。
## 返回示例与解析
缓存命中时业务侧不再发请求，直接消费 `content` 字符串；回源时返回结构同[返回字段全解](https://www.showapi.com/guides/famous-quotes-response-fields-1839)（`showapi_res_body.contentlist`）。
## 进阶 / 边界
- **刷新周期**：名言时效低，1 小时甚至更久补充一次足够；高频回源反而浪费额度。
- **去重**：用 `lpop` 取走一条，避免同一句在短时间内重复展示；想保留可改用 `lindex` + 随机偏移。
- **失败兜底**：回源失败不要击穿到用户侧报错，返回池内剩余或静态兜底句。
- **多实例**：Redis 作为共享池，多服务实例共用，避免各自实时调用叠加额度。
## FAQ
**Q1：缓存会不会让用户总看到同一句？**
A：用 `lpop` 逐条取走 + 定时补充，能在一段时间内轮转不同名言；补充间隔越短轮换越快。
**Q2：多久补充一次合适？**
A：名言低时效，1 小时补充一次通常足够；按你的展示量调整，目标是不超过免费档位。
**Q3：缓存能省多少调用？**
A：若每日展示 1 万次、缓存 1 小时补充 10 条，接口调用可降到约 24×（10/展示条数）量级，节省显著（具体取决于展示量与池大小，不编造固定比例）。
**Q4：多个服务实例会重复调接口吗？**
A：共用同一 Redis 池即不会；回源动作可由一个实例或定时任务承担。
## 相关能力 / 下一步阅读
- [免费名言警句：num 参数怎么用？最多 10 条与"随机返回"机制](https://www.showapi.com/guides/famous-quotes-num-param-1839)
- [免费名言警句：在教育平台 / 网站 / App 中集成"每日一句"](https://www.showapi.com/guides/famous-quotes-app-integration-1839)
- [免费名言警句：常见问题与排查（ret_code 非 0 / 返回为空 / 免费档位限制）](https://www.showapi.com/guides/famous-quotes-faq-1839)
- **本系列共 10 篇**：查看[免费名言警句指南总目录](https://www.showapi.com/guides/famous-quotes-guides-1839)
