• 實作指引版本：0.1.0
• FHIR版本：4.0.1
• 發佈日：2025-03-15

國家級人體生物資料庫整合平台共同資料模式-伺服端

• 國家級人體生物資料庫整合平台共同資料模式-伺服端 必須(SHALL)
1. 可透過FHIR RESTful API查詢Resources
2. 根據FHIR規範實作RESTful
3. HTTP回傳狀態碼:
   • (Status 400)：無效參數(invalid parameter)
   • (Status 401/4xx)：未經授權的請求(unauthorized request)
   • (Status 403)：未充分授權的資料存取範圍(insufficient premission scope)
   • (Status 404)：未知的resource(unknown resource)
4. Server提供的API操作皆支援JSON格式
5. 可識別每個新增到Server的實例(instance)之meta.profile是否為EMR Profiles Defining URL，並確認實例是否依循profile製作。【註：實例是指依據profile實作，將真實資料以JSON、XML或Turtle格式存放的檔案】
• 安全性
1. Server必須(SHALL)透過回傳HTTP 401未授權」，HTTP 403「禁止」，或HTTP 404「未找到」，來拒絕任何未經授權的請求。
• 系統互動能力：
• 可能可以（MAY）支援交易（transaction）
• 可能可以（MAY）支援批次（batch）
• 可能可以（MAY）支援查詢系統（search-system）

應用說明

• 國家級人體生物資料庫整合平台共同資料模式實作指引(NBCT Common Data Model IG)中使用的 Bundle type為「document」，根據 HL7 FHIR 中規定，Bundle type為「document」時第一個資源須為Composition，並且將整個Bundle視為一個文件或報告來傳遞資料。但在癌症登記檔長表(CRLF)中沒有全部的資料都有相對應的國際編碼，因此CRLF資料先暫定不設計Bundle與Composition內容。

Resources或Profiles的RESTful功能

• Profiles
1. 必須(SHALL)支援create、update
• Resources支援查詢，查詢參數如表列：

Resources型別	Profile	支援的Profiles	支援的查詢參數
Bundle	門診醫療申報檔(TOTFA) Bundle,住院醫療申報檔案(TOTFB) Bundle,檢驗檢查資料檔每日格式(LABD) Bundle,檢驗檢查資料檔每月格式(LABM) Bundle,癌症個案管理追蹤資料檔(CASE) Bundle,死亡資料檔(DEATH) Bundle	-	_id,identifier

Bundle

• 預期的遵從度： 建議應該（SHOULD）
• Profile：門診醫療申報檔(TOTFA) Bundle,住院醫療申報檔案(TOTFB) Bundle,檢驗檢查資料檔每日格式(LABD) Bundle,檢驗檢查資料檔每月格式(LABM) Bundle,癌症個案管理追蹤資料檔(CASE) Bundle,死亡資料檔(DEATH) Bundle
• 支援的參照政策（Reference policy）： resolves，Server會嘗試將邏輯參照（logical reference）解析為文字參照，意即轉換Reference.identifier為Reference.reference（但如果解析失敗，Server仍然會接收這個resource，請參閱logical）。
• Profile
• 建議應該（SHOULD）支援 search-type、 read、vread、create、 update、 delete
• 可能可以（MAY）支援 patch
• 查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	GET [base]/Bundle?_id=[id], GET [base]/Bundle/[id]
建議應該（SHOULD）	identifier	token	GET [base]/Bundle?identifier={system|}[code]