FHIR

FHIR 搜索详解:参数、前缀、修饰符、_include 和分页

如何查询 FHIR 服务器:按类型(token、date、reference、string、quantity)搜索参数,前缀(如 ge 和 lt),修饰符(如 :exact 和 :missing),链式查询,_include 和 _revinclude,排序,_count 和分页,并提供实验室结果的示例 URL。

作者 发布于 阅读约 1 分钟

简短回答: FHIR 搜索是一个 REST 查询:GET [base]/[ResourceType]?parameter=value。每种资源都有定义的搜索参数,包含类型,并且可以使用前缀(ge、lt 等)和修饰符(:exact、:missing 等)来细化值。结果会以搜索集 Bundle 的形式返回,并附带分页链接。

参数类型和示例

  • token(代码):Observation?code=http://loinc.org|4548-4
  • date(日期):Observation?date=ge2025-01-01&date=lt2026-01-01;前缀包括 eq、ne、gt、lt、ge、le、sa、eb、ap。
  • reference(引用):Observation?subject=Patient/123(或 patient=123)。
  • string(字符串):Patient?family=smith(默认表示“开头是”;可以使用 :exact 和 :contains 修饰符)。
  • quantity(数量):Observation?value-quantity=gt7|http://unitsofmeasure.org|%。

使用 &(和)进行组合;使用逗号分隔的值表示“或”:code=http://loinc.org|2093-3,http://loinc.org|2571-8。

包含、排序和分页

  • _include=Observation:subject 会将引用的 Patient 添加到结果中;_revinclude=Provenance:target 会添加指向这些资源的资源。
  • 链式查询:Observation?subject:Patient.family=smith。
  • _sort=-date 表示按日期降序排序(最新在前);_count=50 设置每页数量;请遵循 link[relation=next] 中的链接进行分页,而不是自己构建偏移量。
  • _summary=count 只返回总数。

在 Anpheros 中

Anpheros 平台支持在患者授权的范围内,对患者的资源进行标准的 FHIR 搜索。开发者:入门指南、FHIR 沙盒 和 限制说明。

相关页面

来源

常见问题

如何按 LOINC 代码搜索 FHIR Observation?

Observation?code=http://loinc.org|4548-4 (系统|代码)。

如何按日期范围搜索?

重复使用 date 参数并加上前缀:date=ge2025-01-01&date=lt2026-01-01。

_include 的作用是什么?

将结果引用的资源(例如,每个 Observation 对应的 Patient)添加到同一个 Bundle 中。

如何分页浏览结果?

遵循返回的 Bundle 中的 next 链接;使用 _count 设置每页数量。

Anpheros Platform

在沙盒中免费试用

5 分钟完成第一次 FHIR 调用. 一个内置患者授权的 HL7 FHIR R4 API:先在沙盒中试用,然后连接您自己的应用或诊所系统。

免费 · 30 位合成患者 · 无需信用卡

本指南仅供参考,不能替代医生诊疗。涉及健康的决定请咨询医生。紧急情况下,请拨打当地急救电话(欧洲为 112)。
撰写人
Anpheros 团队

Anpheros 致力于打造一个由患者掌控的医疗记录,并可在欧盟的 HL7 FHIR R4 平台上与任何诊所共享。这些指南旨在帮助您理解和整理您的健康信息,但不能替代您的医生。

关于 Anpheros →