健康养生类应用如何集成健康知识 API：从内容栏目到每日推送
# 健康养生类应用如何集成健康知识 API：从内容栏目到每日推送
- **接口/接入点**：健康知识（全部 3 个接入点，免费）
- **请求方式**：POST / GET ｜ **返回格式**：JSON
- **适用人群**：健康类 App / 公众号 / 小程序产品与运营 ｜ **阅读时间**：约 8 分钟
## 核心要点
- 标准内容流：分类列表（`90-86`）搭栏目骨架 → 搜索知识（`90-87`）做检索/栏目内容 → 查看单条详情（`90-88`）做详情页。
- 利用"每日更新"特性，可在服务端定时拉取最新知识，生成"每日养生卡片 / 推送"。
- 免费、即调即用，适合作为健康类产品的稳定内容上游。
## Why：健康产品最缺的就是持续内容
健康类 App、公众号、养生小程序普遍面临"内容从哪来、怎么持续更新"的问题。自己组建编辑团队成本高、专业门槛高。健康知识 API 提供每日更新的健康小知识、保健知识、男女老幼各群体内容与亚健康调理建议，且免费、接口简单，三步就能搭起一个可持续的内容栏目。
## What：三种典型集成形态
| 形态 | 用到接入点 | 说明 |
|------|-----------|------|
| 栏目导航 | 分类列表 `90-86` | 渲染分类菜单 |
| 栏目/搜索列表 | 搜索知识 `90-87` | 按分类或关键词取内容列表 |
| 详情页 | 查看单条 `90-88` | 点击进入完整长文 |
| 每日推送 | 搜索/分类 + 定时任务 | 服务端定时拉取，生成每日卡片 |
## How：内容栏目架构
### 1）栏目骨架（服务端缓存分类）
```python
# 分类列表结果缓存 1 天，作为导航与栏目 id 来源
categories = get_categories() # 见「免费额度策略」缓存写法
# categories: [{"id":103,"name":"综合资讯"}, {"id":101,"name":"疾病科普"}]
```
### 2）栏目内容列表（按分类取第一页）
```python
def column_list(tid, page=1):
resp = requests.post(
"https://route.showapi.com/90-87",
params={"appKey": "YOUR_APPKEY"},
data={"key": "", "tid": str(tid), "page": str(page)},
timeout=15,
).json()
return resp["showapi_res_body"]["pagebean"]["contentlist"]
```
### 3）每日养生卡片（定时任务示意）
```python
def daily_card():
# 每日定时执行：取"综合资讯"或指定分类第一页前几条
items = column_list(tid=103, page=1)[:3]
return [{"title": i["title"], "intro": i.get("intro", ""), "id": i["id"]} for i in items]
# 将 daily_card() 结果推送到 App 首页 / 公众号模板消息
```
## 返回示例与解析
内容列表项可用于卡片展示：
```json
{
"id": "100001",
"title": "感冒了怎么办",
"tname": "疾病科普",
"ctime": "2024-01-15 10:00:00",
"intro": "感冒常见症状与居家应对建议。"
}
```
卡片展示 `title` + `intro` + `tname`（分类标签），点击后调用详情接口取 `content` 长文。
## 进阶 / 边界
- **合规提示**：健康内容涉及养生建议，展示时建议保留"仅供参考、不构成医疗建议"的免责声明，尤其涉及疾病预防/治疗描述时。
- **缓存与限频**：栏目列表可短时缓存（如 5~10 分钟），每日推送走服务端定时任务而非前端实时拉取，见[免费额度策略](https://www.showapi.com/guides/health-knowledge-free-quota-90)。
- **无图兜底**：列表/卡片图片用占位图，详见[内容渲染避坑](https://www.showapi.com/guides/health-knowledge-render-90)。
## FAQ
**Q：适合公众号/小程序吗？**
A：适合。接口返回标准 JSON，任何能发起 HTTP 请求的服务端都能接入；前端通过你自己的后端代理调用，避免 appKey 暴露。
**Q：能做"每日推送"吗？**
A：可以。接口每日更新，在服务端用定时任务拉取最新内容，生成卡片推送到 App 首页或公众号模板消息即可。
**Q：内容是否可直接当作医疗建议发布？**
A：不建议。健康养生内容请保留"仅供参考"的免责声明，涉及疾病诊疗的描述应引导用户咨询专业医生。
**Q：免费能支撑生产环境吗？**
A：接口免费且有防滥用档位限制（具体阈值以官方为准），配合缓存与限频可支撑常规内容栏目；高频大规模场景请关注官方档位说明。
## 相关能力与下一步阅读
- [健康知识 API：分类列表怎么用？先拿分类 ID 再精准筛选](https://www.showapi.com/guides/health-knowledge-category-90)
- [健康知识 API：搜索知识接入实战（关键词 / 分类 / 分页）](https://www.showapi.com/guides/health-knowledge-search-90)
- [健康知识 API：免费额度与档位限制下的合理调用策略](https://www.showapi.com/guides/health-knowledge-free-quota-90)
- **本系列共 12 篇**：查看[健康知识 API 使用指南总目录](https://www.showapi.com/guides/health-knowledge-guides-90)
