核心用法
本技能提供中医药方剂的API查询能力,通过调用 https://119.91.226.122/api 实现以下功能:
1. 方剂搜索
- 支持中文方剂名、药物组成等关键词模糊搜索
- 可搭配分类筛选,分页返回结果
2. 方剂详情
- 获取完整方剂资料:名称、别名、组成、功用、主治、方解、方歌、用法、禁忌、加减变化、来源
3. 分类浏览
- 查看所有方剂分类(解表剂、清热剂、泻下剂等),支持按分类检索
4. 症状推荐(需认证)
- POST 接口接收症状描述数组,返回匹配的方剂及推荐理由
认证方式:通过环境变量 TCM_API_KEY 配置API Key,避免在对话中暴露密钥。
---
显著优点
- 数据覆盖全面:涵盖方剂组成、功用、主治、方解、方歌、用法、禁忌等完整字段,信息结构化程度高
- 多语言支持:支持中英文关键词搜索,适配不同用户习惯
- 症状智能匹配:基于症状描述推荐方剂,降低用户专业知识门槛
- 安全认证机制:API Key通过环境变量管理,符合安全最佳实践
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| **服务可用性风险** | API服务器IP `119.91.226.122` 未使用域名,若IP变更或服务器下线则服务中断 |
| **认证门槛** | 症状推荐等核心功能需注册获取API Key,增加使用成本 |
| **速率限制** | 每分钟100次请求,高频场景可能受限 |
| **数据权威性** | 未说明数据来源(古籍、教材还是临床),专业准确性需交叉验证 |
| **无HTTPS强制** | 文档使用HTTP示例,虽地址可支持HTTPS,但未明确加密传输要求 |
适合人群
- 中医药学习者、从业者需要快速查询方剂资料
- 健康类应用开发者集成方剂数据服务
- 对中医感兴趣的用户通过症状了解对应方剂
常规风险
1. 医疗决策风险:方剂信息仅供参考,实际用药需经专业中医师辨证论治,不可直接作为自我诊疗依据
2. 数据准确性风险:API返回的方剂组成、禁忌等信息可能存在录入误差,关键用药建议应以权威典籍为准
3. 隐私合规风险:症状推荐功能上传用户健康信息,需确认服务商的数据处理合规性
4. 服务连续性风险:IP直联架构缺乏容灾能力,建议生产环境做好降级预案