FHIR Bulk Data

• 您正在建立一個大量資料用戶端，需要啟動匯出作業、輪詢狀態，並從 FHIR 伺服器下載 NDJSON 檔案。
• 您正在實作伺服器端的 $export 支援，並需要了解合規性要求、清單結構或 CapabilityStatement 宣告。
• 您需要使用 _type、_since 或 _typeFilter 等參數，依資源類型、日期範圍或 FHIR 搜尋條件篩選大型匯出作業。
• 您正在整合 SMART Backend Services（OAuth 2.0 用戶端憑證 + JWT），以實現安全的伺服器對伺服器大量存取。

• 您只需要透過標準 REST 擷取個別 FHIR 資源——請改用一般的 FHIR 技能。
• 您的使用情境涉及即時或近即時的資料串流，而非批次匯出。
• 您正在使用不符合 HL7 Bulk Data Access IG 的專有批次匯出格式。

引導您完成批量匯出生命週期的每個階段：啟動請求、202 Accepted 處理、使用 Retry-After 與 X-Progress 的狀態輪詢、清單解析、檔案下載，以及 DELETE 清理。

涵蓋 Patient/$export（所有病患）、Group/[id]/$export（群組範圍）與 [base]/$export（系統層級），包括各端點的適用時機，以及範圍界定如何影響輸出結果。

所有支援參數的詳細說明：_outputFormat、_since、_until、_type、_elements、_typeFilter、includeAssociatedData、organizeOutputBy 以及 allowPartialManifests。

產生與使用換行分隔 JSON 的精確規則：每行一個資源、UTF-8 編碼、正確的行終止符、無嵌入換行符，以及正確的媒體類型（application/fhir+ndjson）。

說明用於大量伺服器對伺服器存取所需的 OAuth 2.0 用戶端憑證流程與 JWT 斷言，包括權杖請求結構及持有者權杖的使用方式。

涵蓋 OperationOutcome 解讀、速率限制（429 Too Many Requests）、權杖過期（401）、工作不存在（404），以及建構具備韌性的輪詢用戶端策略。

實作一個用戶端，能夠發起匯出請求、以指數退避法輪詢狀態 URL、解析完整的清單檔案，並串流傳輸 NDJSON 檔案以供下游處理使用。

設定 FHIR 伺服器以支援 $export，在每個工作流程階段回傳正確的 HTTP 回應，並透過 CapabilityStatement 宣告符合性。

使用 Group/$export 搭配 _type、_since 和 _typeFilter 參數，僅匯出特定分析或研究使用情境所需的資源類型與日期範圍。

透過解讀 OperationOutcome 回應、了解 HTTP 狀態碼語意，以及處理部分清單檔（partial manifests）與分頁輸出等邊緣案例，診斷並解決 FHIR Bulk Data 批次匯出錯誤。