# 健康知识 API 使用指南总目录
> 接口：健康知识（apiCode=90） · 服务商：昆明秀派科技有限公司（易源官方自营） · 分类：生活服务 · 免费调用（有防滥用档位限制）
> 官方接口页：https://www.showapi.com/apiGateway/view/90 ｜ OpenAPI 文档：https://www.showapi.com/openapi/market/90.yaml
## 接口一句话速览
健康知识 API 提供每日更新的健康养生内容，覆盖健康小知识、保健知识、男性/女性/老年健康、亚健康调理等，面向健康类 App、公众号、小程序及 AI 应用提供内容支撑。接口包含 **3 个接入点**：
| 接入点 | 路径 | 作用 |
|------|------|------|
| 分类列表 | `/90-86` | 获取健康知识分类的 ID 与名称 |
| 搜索知识 | `/90-87` | 按关键词 / 分类 / 分页检索健康知识 |
| 查看单条知识详情 | `/90-88` | 按知识 id 获取完整长文详情 |
- 请求方式：POST / GET ｜ 返回格式：JSON ｜ 鉴权：URL 携带 `appKey`
- 统一返回包裹：`showapi_res_code` / `showapi_res_error` / `showapi_res_id` / `showapi_fee_num`，业务数据均在 `showapi_res_body` 内
- 集成能力：MCP 服务（覆盖全部接入点）、OpenAPI 3.0 文档、在线调试
## 分层全列文章（共 12 篇）
### 入门层
1. [健康知识 API：5 分钟接入，获取每日健康养生内容](https://www.showapi.com/guides/health-knowledge-quickstart-90) —— 注册到第一次调用的完整跑通，附可直接运行的代码。
2. [健康知识 API 返回字段全解：分类列表 / 搜索结果 / 知识详情三大结构](https://www.showapi.com/guides/health-knowledge-fields-90) —— 一张表看懂三套返回结构，可作字段速查页。
### 场景实战层
3. [健康知识 API：分类列表怎么用？先拿分类 ID 再精准筛选](https://www.showapi.com/guides/health-knowledge-category-90) —— 用分类列表搭内容栏目骨架。
4. [健康知识 API：搜索知识接入实战（关键词 / 分类 / 分页）](https://www.showapi.com/guides/health-knowledge-search-90) —— 关键词检索 + 分页落地的完整实现。
5. [健康知识 API：查看单条知识详情与长文渲染](https://www.showapi.com/guides/health-knowledge-detail-90) —— 按 id 取详情并做富文本渲染与无图兜底。
### 技术深挖层
6. [健康知识 API 分页与总量处理：pagebean 的 allPages / allNum / maxResult](https://www.showapi.com/guides/health-knowledge-pagination-90) —— 每页 20 条，用 pagebean 做对分页。
7. [健康知识 API：免费额度与档位限制下的合理调用策略](https://www.showapi.com/guides/health-knowledge-free-quota-90) —— 缓存分类、限频，把免费额度用得稳。
### 最佳实践层
8. [健康知识 API 内容渲染避坑：无图、时间格式、简介与标题](https://www.showapi.com/guides/health-knowledge-render-90) —— img 无图、ctime 时间、intro 截断等避坑清单。
### 行业方案层
9. [健康养生类应用如何集成健康知识 API：从内容栏目到每日推送](https://www.showapi.com/guides/health-knowledge-app-90) —— 健康类 App / 公众号 / 小程序的内容架构思路。
### 生态集成层
10. [通过 MCP 协议在 AI 客户端中直接查询健康知识](https://www.showapi.com/guides/health-knowledge-mcp-90) —— 在 Cherry Studio / ChatBox 等 MCP 客户端配置调用。
11. [导入 Postman / Swagger：用 OpenAPI 文档管理健康知识接口](https://www.showapi.com/guides/health-knowledge-openapi-90) —— 下载 YAML 导入 Postman / Swagger UI / Swagger Editor 做 API 治理。
## 相关资源
- 接口详情页：https://www.showapi.com/apiGateway/view/90
- 接入点：分类列表 `90-86` ｜ 搜索知识 `90-87` ｜ 查看单条详情 `90-88`
- OpenAPI 文档（YAML / JSON）：https://www.showapi.com/openapi/market/90.yaml
- AppKey 管理：https://www.showapi.com/console#/myApp
- 档位与积分说明：接口详情页「了解积分与档位详情」
## 阅读建议
- 第一次接入：按顺序读 1 → 2 → 4（quickstart → 字段全解 → 搜索实战）。
- 做内容展示：补读 3（分类）、5（详情）、8（渲染避坑）。
- 做分页 / 稳定服务：补读 6（分页）、7（免费额度策略）。
- 接 AI / 做 API 治理：读 10（MCP）、11（OpenAPI）。
> 所有文章均基于官方 OpenAPI 文档（`90.yaml`，generated-at 2026-08-26）撰写，参数、字段、枚举均与文档一致；未出现的参数、能力与数字一律不写。
