1. FHIR _summary 参数概述
在医疗健康信息交换领域,FHIR(Fast Healthcare Interoperability Resources)标准已经成为事实上的行业规范。其中_summary参数是一个经常被忽视但极其重要的查询控制参数,它直接影响API返回结果的详细程度和系统性能。我在实际医疗系统集成项目中发现,合理使用_summary参数可以减少80%以上的不必要数据传输量。
这个参数本质上是一种"数据裁剪"机制,允许客户端明确告知服务器:"我只需要资源的特定部分内容"。对于带宽有限的移动医疗应用、需要快速响应的急诊场景,或者仅需资源元数据的批量处理任务,_summary参数能显著提升系统交互效率。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. _summary 参数的核心作用解析
2.1 数据量控制的三重境界
_summary参数提供了三个级别的数据控制粒度:
-
布尔型标记(true/false):最基础的开关模式
_summary=true:返回"标记为摘要元素"的字段(由资源定义指定)- 未指定或
_summary=false:返回完整资源
-
预定义摘要类型:更精细的控制维度
_summary=text:仅返回资源的文本展示(narrative)_summary=data:仅返回数据元素(排除文本展示)_summary=count:仅返回匹配资源数量(不包含实际资源)
-
自定义字段集:最灵活的方案
_summary=elements=<list>:指定返回的精确字段列表
2.2 典型应用场景对比
| 场景类型 | 推荐参数 | 数据量减少比例 | 适用案例 |
|---|---|---|---|
| 资源列表展示 | _summary=true |
40-60% | 患者列表、医嘱列表 |
| 审计日志 |
