健康知识 API：免费额度与档位限制下的合理调用策略
# 健康知识 API：免费额度与档位限制下的合理调用策略
- **接口/接入点**：健康知识（全部 3 个接入点，免费）
- **请求方式**：POST / GET ｜ **返回格式**：JSON
- **适用人群**：已接入用户、后端架构师 ｜ **阅读时间**：约 8 分钟
## 核心要点
- 健康知识 API 是**免费服务**，注册后默认可调用，但设有防止滥用的档位限制（具体档位阈值官方未公开数字，以官方说明为准）。
- 分类列表几乎不变，最适合缓存；搜索/详情可结合业务做短时缓存与限频。
- 合理缓存 + 限频既能提升响应速度，也能把免费额度用在"真正变化的请求"上。
## Why：免费不等于可以无脑刷
免费接口最大的隐性成本是"不稳定"：一旦触发防滥用限制，调用会失败、内容页变空白。与其事后排查，不如在设计阶段就把缓存与限频做进去。对内容型接口而言，健康知识每日更新，绝大多数场景下"秒级实时"并无必要，缓存几分钟完全够用。
## What：限制与事实边界
| 事实 | 说明 |
|------|------|
| 免费 | 注册默认可调用；是否需积分/档位以官方档位说明为准 |
| 防滥用档位 | 官方设档位限制，但具体阈值（如每日/每分钟上限）**文档未公开数字** |
| 更新频率 | 文档称"每日更新"，即内容按天变化，非秒级实时 |
> 重要：本文所有建议均不涉及任何具体阈值数字，因为官方未公开。请以其[官方档位说明](https://www.showapi.com/apiGateway/view/90)为准。
## How：缓存与限频的可落地写法
### 1）缓存分类列表（几乎不变）
```python
import time, requests
CACHE_TTL = 86400 # 1 天
_cache = {"ts": 0, "data": None}
def get_categories():
now = time.time()
if _cache["data"] and now - _cache["ts"] < CACHE_TTL:
return _cache["data"]
resp = requests.post(
"https://route.showapi.com/90-86",
params={"appKey": "YOUR_APPKEY"}, timeout=10
).json()
_cache.update(ts=now, data=resp["showapi_res_body"]["list"])
return _cache["data"]
```
### 2）搜索结果短时缓存（避免重复翻页刷接口）
```python
import hashlib, time
search_cache = {}
def search(key, tid, page, ttl=300): # 缓存 5 分钟
k = hashlib.md5(f"{key}|{tid}|{page}".encode()).hexdigest()
now = time.time()
if k in search_cache and now - search_cache[k]["ts"] < ttl:
return search_cache[k]["data"]
resp = requests.post(
"https://route.showapi.com/90-87",
params={"appKey": "YOUR_APPKEY"},
data={"key": key, "tid": tid, "page": page}, timeout=15
).json()
search_cache[k] = {"ts": now, "data": resp}
return resp
```
### 3）简单限频（令牌桶思路，防止突发刷爆）
```python
import time
class SimpleLimiter:
def __init__(self, rate=5, per=1.0): # 每秒最多 5 次
self.rate, self.per, self.tokens, self.ts = rate, per, rate, time.time()
def allow(self):
now = time.time()
self.tokens = min(self.rate, self.tokens + (now - self.ts) * self.rate / self.per)
self.ts = now
if self.tokens >= 1:
self.tokens -= 1
return True
return False
```
## 返回示例与解析
本篇为策略性内容，无特定返回结构；核心是把"分类缓存 + 搜索短时缓存 + 全局限频"组合进调用层，调用代码本身与[搜索实战](https://www.showapi.com/guides/health-knowledge-search-90)、[分类列表](https://www.showapi.com/guides/health-knowledge-category-90)一致，仅在外层加缓存/限频。
## 进阶 / 边界
- **缓存失效策略**：分类用长 TTL（如 1 天）+ 手动刷新钩子；搜索用短 TTL（如 5 分钟）；详情可按 id 缓存数分钟。
- **失败兜底**：调用失败时返回上一次缓存结果（标注"数据可能延迟"），比直接空白更友好。
- **不要编造阈值**：任何"每日 X 次""每分钟 Y 次"的数字都不要写进代码注释或文档，以官方档位说明为准。
## FAQ
**Q：免费接口有没有调用量上限？**
A：官方设有防止滥用的档位限制，但具体阈值（每日/每分钟上限）未在文档中公开数字，请以官方档位说明为准；本文的限频代码仅作自我保护，不代表官方阈值。
**Q：缓存会不会导致内容不更新？**
A：合理设置 TTL 即可。健康知识每日更新，分类用 1 天、搜索用 5 分钟级别的缓存，用户几乎无感，却能显著降低调用量。
**Q：appKey 暴露在前端会有问题吗？**
A：会。appKey 是鉴权凭证，应仅在服务端调用；前端如需展示内容，应走你自己的后端代理转发，避免泄露与额度被刷。
**Q：触发限制后怎么恢复？**
A：以降低频率、命中缓存为主；具体恢复规则以官方档位说明为准。
## 相关能力与下一步阅读
- [健康知识 API：分类列表怎么用？先拿分类 ID 再精准筛选](https://www.showapi.com/guides/health-knowledge-category-90)
- [健康知识 API：搜索知识接入实战（关键词 / 分类 / 分页）](https://www.showapi.com/guides/health-knowledge-search-90)
- [健康知识 API 分页与总量处理：pagebean 的 allPages / allNum / maxResult](https://www.showapi.com/guides/health-knowledge-pagination-90)
- **本系列共 12 篇**：查看[健康知识 API 使用指南总目录](https://www.showapi.com/guides/health-knowledge-guides-90)
