THDS 提供基于 FHIR R4 标准的医疗健康数据存储与访问服务，支持资源级数据写入、读取、检索以及批量事务处理能力。接口设计遵循标准化资源模型与 RESTful 风格，便于与医院信息系统、临床应用、科研平台及第三方集成系统进行对接。
能力范围
平台当前提供的 FHIR 操作接口主要覆盖以下三类能力：
CRUD 操作能力：支持对标准 FHIR 资源执行创建、读取、更新、删除、局部更新以及历史版本读取等操作，适用于单条资源的生命周期管理。
搜索与检索能力：支持基于条件表达式的资源搜索，包括基础搜索、引用搜索、数值搜索、日期时间搜索、分页、排序以及患者全量信息检索等场景。
Bundle 事务与批处理能力：支持通过 Bundle 在单次请求中提交多个资源交互操作，并支持 transaction 与 batch 两种处理模式，适用于批量写入、关联资源提交、条件创建、条件更新等场景。
接口特点
标准化：接口遵循 FHIR 资源模型与交互语义，便于与已有 FHIR 生态对接。
资源化：所有数据通过标准资源进行表达和访问，例如 Patient、Observation、Encounter 等。
可扩展：支持通过标准搜索参数、事务 Bundle 及资源引用机制实现更复杂的数据交互流程。
易集成：基于 HTTP 与 JSON 进行交互，便于被 Web 应用、服务集成平台及业务系统调用。
主要接口分类
资源基础操作接口
CRUD 接口用于完成资源的基础生命周期管理，适用于患者主数据维护、检验结果更新、诊疗记录归档及历史版本追溯等场景。主要有以下接口：
|
| 创建新的资源实例。 |
| 读取资源的最新版本内容。 |
| 读取资源的指定历史版本内容。 |
| 更新指定资源的完整内容。 |
| 对资源局部字段执行增量修改。 |
| 删除指定资源，通常为逻辑删除。 |
搜索操作接口
搜索接口用于按条件筛选资源数据，适用于患者检索、就诊记录查询、检验结果筛选、诊断文本匹配及全量病历聚合等场景。支持以下典型检索方式：
|
| 按单个或多个常规字段检索资源。 |
| 按资源之间的关联关系进行检索。 |
| 面向检验值、测量值等数值字段进行过滤。 |
| 面向日期、时间范围及更新时间进行过滤。 |
| 支持大结果集分页获取。 |
| 支持按指定字段排序返回结果。 |
| 支持通过 $everything 获取患者全景数据。 |
Bundle 请求接口
Bundle 接口用于在单次请求中提交多个操作，适用场景包括批量导入数据、一次性写入关联资源、避免重复建档及减少接口调用次数等场景。主要有以下接口：
|
| 通过单个 Bundle 请求提交一个或多个 FHIR 交互操作。 |
| 在同一 Bundle 中提交多条存在业务关联的资源。 |
| 使用临时占位符 ID 建立同一事务内资源之间的引用关系。 |
| 按业务条件判断目标资源是否已存在，不存在时创建资源。 |
| 按业务条件定位目标资源，并对匹配资源执行更新。 |
| 在事务 Bundle 中对指定资源执行删除操作。 |
| 在事务 Bundle 中对指定资源执行局部更新。 |