帮你快速理解、总结文档立即下载

API 概览

最近更新时间:2026-07-28 16:18:00

我的收藏
THDS 提供基于 FHIR R4 标准的医疗健康数据存储与访问服务,支持资源级数据写入、读取、检索以及批量事务处理能力。接口设计遵循标准化资源模型与 RESTful 风格,便于与医院信息系统、临床应用、科研平台及第三方集成系统进行对接。

能力范围

平台当前提供的 FHIR 操作接口主要覆盖以下三类能力:
CRUD 操作能力:支持对标准 FHIR 资源执行创建、读取、更新、删除、局部更新以及历史版本读取等操作,适用于单条资源的生命周期管理。
搜索与检索能力:支持基于条件表达式的资源搜索,包括基础搜索、引用搜索、数值搜索、日期时间搜索、分页、排序以及患者全量信息检索等场景。
Bundle 事务与批处理能力:支持通过 Bundle 在单次请求中提交多个资源交互操作,并支持 transactionbatch 两种处理模式,适用于批量写入、关联资源提交、条件创建、条件更新等场景。

接口特点

标准化:接口遵循 FHIR 资源模型与交互语义,便于与已有 FHIR 生态对接。
资源化:所有数据通过标准资源进行表达和访问,例如 PatientObservationEncounter 等。
可扩展:支持通过标准搜索参数、事务 Bundle 及资源引用机制实现更复杂的数据交互流程。
易集成:基于 HTTP 与 JSON 进行交互,便于被 Web 应用、服务集成平台及业务系统调用。

主要接口分类

资源基础操作接口

CRUD 接口用于完成资源的基础生命周期管理,适用于患者主数据维护、检验结果更新、诊疗记录归档及历史版本追溯等场景。主要有以下接口:
接口
说明
Create
创建新的资源实例。
Read
读取资源的最新版本内容。
vRead
读取资源的指定历史版本内容。
Update
更新指定资源的完整内容。
Patch
对资源局部字段执行增量修改。
Delete
删除指定资源,通常为逻辑删除。

搜索操作接口

搜索接口用于按条件筛选资源数据,适用于患者检索、就诊记录查询、检验结果筛选、诊断文本匹配及全量病历聚合等场景。支持以下典型检索方式:
接口
说明
按单个或多个常规字段检索资源。
按资源之间的关联关系进行检索。
面向检验值、测量值等数值字段进行过滤。
面向日期、时间范围及更新时间进行过滤。
支持大结果集分页获取。
支持按指定字段排序返回结果。
支持通过 $everything 获取患者全景数据。

Bundle 请求接口

Bundle 接口用于在单次请求中提交多个操作,适用场景包括批量导入数据、一次性写入关联资源、避免重复建档及减少接口调用次数等场景。主要有以下接口:
接口
说明
通过单个 Bundle 请求提交一个或多个 FHIR 交互操作。
在同一 Bundle 中提交多条存在业务关联的资源。
使用临时占位符 ID 建立同一事务内资源之间的引用关系。
按业务条件判断目标资源是否已存在,不存在时创建资源。
按业务条件定位目标资源,并对匹配资源执行更新。
在事务 Bundle 中对指定资源执行删除操作。
在事务 Bundle 中对指定资源执行局部更新。