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 HTTP 請求、協商內容格式、使用 ETags 管理資源版本，並解析 OperationOutcome 錯誤。

實作發布至基礎 URL 的 FHIR 批次或交易 Bundle，處理混合操作類型與不可分割的交易語意。

在投入實作之前，依據 HL7 規範驗證規劃中的 FHIR API 路由結構與操作對應關係。