健康管理平台集成药品信息查询：从用药提醒到说明书展示
# 健康管理平台集成药品信息查询：从用药提醒到说明书展示
- **接口/接入点**：药品信息查询（apiCode=1468）· 1468-3 / 1468-4
- **是否免费**：免费（有档位限制）
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：医药/健康平台从业者、产品经理
- **阅读时间**：约 5 分钟
## 核心要点
- 药品信息查询返回的说明书级字段（适应症、成份、用法用量、禁忌、相互作用、有效期）可直接驱动「用药提醒」「说明书展示」「相互作用预警」等健康场景。
- 典型链路：用户输入药名 → 1468-4 取 `drugId` → 1468-3(`searchType=4`) 取完整详情 → 结构化落库展示。
- 健康场景强调**不替代医嘱**：注意事项/禁忌等字段展示时需加免责声明。
## Why：健康平台为什么需要它
用户拍照或输入药名就想看「这药治什么、怎么吃、和我在吃的 XX 冲突吗」。药品信息查询把零散的说明书数据结构化输出，省去平台自己维护药品知识库。
## What：可用字段映射到功能
| 功能 | 用到字段 |
|------|------|
| 用药提醒 | `yfyl`(用法用量)、`gg`(规格) |
| 说明书展示 | `syz`(适应症)、`zycf`(成份)、`blfy`(不良反应)、`zxbz`(执行标准) |
| 禁忌提示 | `jj`(禁忌)、`zysx`(注意事项) |
| 相互作用预警 | `ywxhzy`(药物相互作用) |
| 效期管理 | `yxq`(有效期)、`zc`(贮藏) |
## How：从搜索到结构化落地
```python
import requests
APPKEY = "YOUR_APPKEY"
def get_drug_detail(drug_name):
# 1) 药名检索拿 drugId
s = requests.post("https://route.showapi.com/1468-4",
data={"appKey": APPKEY, "searchKey": drug_name, "page": "1", "maxResult": "5"},
timeout=10).json()["showapi_res_body"]
if not s.get("drugList"):
return None
drug_id = s["drugList"][0]["drugId"]
# 2) 按药品Id 取完整详情
d = requests.post("https://route.showapi.com/1468-3",
data={"appKey": APPKEY, "searchType": "4", "searchKey": drug_id, "page": "1"},
timeout=10).json()["showapi_res_body"]["drugList"][0]
return {
"name": d["drugName"], "usage": d.get("yfyl"), "avoid": d.get("jj"),
"caution": d.get("zysx"), "interaction": d.get("ywxhzy"), "expiry": d.get("yxq"),
}
```
## 返回示例与解析
`drugList[0]` 含 `yfyl`(如「口服。一次6克，一日2次。」)、`jj`(禁忌)、`zysx`(注意事项)、`ywxhzy`(药物相互作用)、`yxq`(有效期，如「48个月。」)。这些字符串直接渲染到前端卡片即可。
## 进阶 / 边界
- **免责声明**：展示禁忌/相互作用时必须标注「仅供参考，不替代专业医疗建议」。
- **多分类**：一个药 `type` 数组可能归属多个科别，展示时全部列出。
- **价格**：如需展示价格用 `price` 但标注参考价（见[price 字段一文](https://www.showapi.com/guides/drug-info-price-1468)）。
- 数据量大时按[缓存策略](https://www.showapi.com/guides/drug-info-cache-1468)落地，减少实时调用。
## FAQ
**Q1：能直接用返回数据做用药决策吗？**
A：不能。返回为药品说明书信息，仅供查询参考，实际用药请遵医嘱；前端须加免责声明。
**Q2：相互作用字段为空代表没有相互作用吗？**
A：不代表。返回「尚不明确」或空仅是数据源未提供，不能据此推断安全，应提示用户咨询医师或药师。
**Q3：一个药为什么出现多个分类？**
A：药品可跨科别归属（如安神丸既属感冒发热也属精神心理），`type` 是数组，展示时全部列出即可。
## 相关能力 / 下一步阅读
- [免费档位限制下，如何设计缓存策略批量同步药品数据？](https://www.showapi.com/guides/drug-info-cache-1468)
- [药名查询药品信息（1468-4）实战指南](https://www.showapi.com/guides/drug-info-search-name-1468)
- [药品参考价格（price）字段解读与使用注意](https://www.showapi.com/guides/drug-info-price-1468)
- **本系列共 11 篇**：查看[药品信息查询指南总目录](https://www.showapi.com/guides/drug-info-guides-1468)
