FHIR API

• 您正在构建符合 FHIR 规范的 REST 服务器，需要了解正确的端点模式、状态码以及 CapabilityStatement 结构。
• 您正在编写 FHIR 客户端，需要正确处理 ETag、内容协商以及 OperationOutcome 响应。
• 您正在设计 FHIR API 路由，希望在编写代码之前确保与 HL7 规范保持一致。
• 您需要实现批处理或事务 Bundle，并希望获得有关正确请求/响应格式的指导。

• 您正在使用 FHIR 消息传递或文档范式，而非 RESTful API 交互模型。
• 您需要有关 FHIR 分析、StructureDefinitions 或术语服务的指导，这些内容超出了 FHIR API 技能的范围。

涵盖所有核心 FHIR API REST 交互操作：read、vread、create、update、patch、delete、search、history、capabilities 以及 batch/transaction——并使用正确的 HTTP 方法、URL 模式和成功状态码。

解释 FHIR MIME 类型（application/fhir+json、application/fhir+xml、application/fhir+turtle）、Accept 和 Content-Type 请求头的正确使用方式、FHIR 版本协商，以及 _format 回退参数。

指导使用 If-Match 请求头实现基于 ETag 的版本跟踪，并说明如何处理 412 Precondition Failed 响应，以确保并发更新的安全性。

提供正确的 OperationOutcome 响应结构，并将 FHIR 特定的 HTTP 状态码（400、404、409、410、412、422）映射到其对应的适用场景。

说明如何遵循 Prefer 标头，以支持 return=minimal、return=representation、return=OperationOutcome 以及使用 202 Accepted 的异步操作模式。

包含一份实用检查清单，涵盖 /metadata 处的 CapabilityStatement、ETag 支持、创建/更新时的 Location 响应头，以及 _format 参数回退，帮助确保符合规范要求。

构建符合规范的 FHIR REST 服务器，包含正确的路由处理程序、响应头以及针对 Patient、Observation 或 DiagnosticReport 等资源类型的错误响应。

开发一个客户端，能够正确构建 FHIR API HTTP 请求、协商内容格式、使用 ETag 管理资源版本，并解析 OperationOutcome 错误。

实现发布到基础 URL 的 FHIR API 批量或事务包，处理混合操作类型及原子事务语义。

在提交实现方案之前，根据 HL7 规范验证计划中的 FHIR API 路由结构和操作映射。