• 實作指引版本：0.1.0
• FHIR版本：4.0.1
• 發佈日：2022-12-20
• 發佈者：ABC科技股份有限公司

Server的FHIR RESTful功能要求

• 同意書-伺服端 必須(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是否為TW Core Profiles Defining URL，並確認實例是否依循profile製作。【註：實例是指依據profile實作，將真實資料以JSON、XML或Turtle格式存放的檔案】
6. 支援每個profile的查詢參數
• 同意書-伺服端 建議應該(SHOULD)
1. Server提供的API操作皆支援XML格式
• 安全性
1. Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求

Resources或Profiles的RESTful功能

• 共有四類Resources支援查詢，查詢參數如表列：

Resources型別	Profile	支援的Profiles	支援的查詢參數	支援_includes(未來視情況新增)	支援_revincludes(未來視情況新增)	支援Operations(未來視情況新增)
Bundle	-	長期照顧司籌備辦公室-切結書(Bundle-DOLTC-AFFT), 長期照顧司籌備辦公室-長期照顧需要評估結果通知單(Bundle-DOLTC-LTCNA), 長期照顧司籌備辦公室-個人資料蒐集、處理及利用告知事項(Bundle-DOLTC-PDCPUA), 長期照顧司籌備辦公室-個案服務管理申請書(Bundle-DOLTC-CMAF), 衛生福利部國民健康署-兒童版同意書(Bundle-HPA-CFK7-12Y), 衛生福利部國民健康署-受試者同意書(Bundle-HPA-CFS7-20Y), 醫事司-安寧療護意願書(Bundle-DOMA-CFPC), 醫事司-器官捐贈同意書(Bundle-DOMA-CFOD)	_id, composition, timestamp	-	-	-
Composition	同意書Composition(Composition-CF)	-	author, subject	-	-	-
Consent	同意書(Consent-Base)	長期照顧司籌備辦公室-切結書(Consent-DOLTC-AFFT), 長期照顧司籌備辦公室-長期照顧需要評估結果通知單(Consent-DOLTC-LTCNA), 長期照顧司籌備辦公室-個人資料蒐集、處理及利用告知事項(Consent-DOLTC-PDCPUA), 長期照顧司籌備辦公室-個案服務管理申請書(Consent-DOLTC-CMAF), 衛生福利部國民健康署-兒童版同意書(Consent-HPA-CFK7-12Y), 衛生福利部國民健康署-受試者同意書(Consent-HPA-CFS7-20Y), 醫事司-安寧療護意願書(Consent-DOMA-CFPC), Consent-doma-cfod	_id, category	-	-	-
DocumentReference	同意書-參照的文件(DocumentReference-CF)	-	-	-	-	-

Bundle

• 預期的符合性(Conformance Expectation)： 必須(SHALL)
• 支援的Profiles： 長期照顧司籌備辦公室-切結書(Bundle-DOLTC-AFFT), 長期照顧司籌備辦公室-長期照顧需要評估結果通知單(Bundle-DOLTC-LTCNA), 長期照顧司籌備辦公室-個人資料蒐集、處理及利用告知事項(Bundle-DOLTC-PDCPUA), 長期照顧司籌備辦公室-個案服務管理申請書(Bundle-DOLTC-CMAF), 衛生福利部國民健康署-兒童版同意書(Bundle-HPA-CFK7-12Y), 衛生福利部國民健康署-受試者同意書(Bundle-HPA-CFS7-20Y), 醫事司-安寧療護意願書(Bundle-DOMA-CFPC), 醫事司-器官捐贈同意書(Bundle-DOMA-CFOD)
• 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。
• Profile
• 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch
• 查詢參數摘要

符合性(Conformance)	參數	類型	範例
必須(SHALL)	_id	token	GET [base]/Bundle?_id=[id], GET [base]/Bundle/[id]
必須(SHALL)	composition	reference	GET [base]/Bundle?composition.author={Type/}[id], GET [base]/Bundle?composition.subject={Type/}[id]
必須(SHALL)	timestamp	date	GET [base]/Bundle?timestamp={gt|lt|ge|le}[date]

Composition

• 預期的符合性(Conformance Expectation)： 必須(SHALL)
• Profiles： 同意書Composition(Composition-CF
• 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。
• Profile
• 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch
• 查詢參數摘要

符合性(Conformance)	參數	類型	範例
必須(SHALL)	author	reference	GET [base]/Composition?author={Type/}[id]
必須(SHALL)	subject	reference	GET [base]/Composition?subject={Type/}[id]

Consent

• 預期的符合性(Conformance Expectation)： 必須(SHALL)
• Profiles： 同意書(Consent-Base)
• 支援的Profiles： 長期照顧司籌備辦公室-切結書(Consent-DOLTC-AFFT), 長期照顧司籌備辦公室-長期照顧需要評估結果通知單(Consent-DOLTC-LTCNA), 長期照顧司籌備辦公室-個人資料蒐集、處理及利用告知事項(Consent-DOLTC-PDCPUA), 長期照顧司籌備辦公室-個案服務管理申請書(Consent-DOLTC-CMAF), 衛生福利部國民健康署-兒童版同意書(Consent-HPA-CFK7-12Y), 衛生福利部國民健康署-受試者同意書(Consent-HPA-CFS7-20Y), 醫事司-安寧療護意願書(Consent-DOMA-CFPC), Consent-doma-cfod
• 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。
• Profile
• 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch
• 查詢參數摘要

符合性(Conformance)	參數	類型	範例
必須(SHALL)	_id	token	GET [base]/Consent?_id=[id], GET [base]/Consent/[id]
必須(SHALL)	category	token	GET [base]/Consent?category={system|}[code]

DocumentReference

• 預期的符合性(Conformance Expectation)： 必須(SHALL)
• Profiles： 同意書-參照的文件(DocumentReference-CF)
• 支援的參照政策(Reference policy)： resolves，Server會嘗試將邏輯參照(logical reference)解析為文字參照，意即轉換Reference.identifier為Reference.reference(但如果解析失敗，Server仍然會接收這個resource，請參閱 logical)。
• Profile
• 必須(SHALL)支援 create、 read、 update、 vread、 search-type、 patch