臺灣中醫實作指引
0.1.0 - ci-build

臺灣中醫實作指引, published by 衛生福利部國家中醫藥研究所. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/nricmig/Nricm_TWCMIG/ and changes regularly. See the Directory of published versions

CapabilityStatement: 臺灣中醫實作指引-伺服端(TWCM Server)

Official URL: https://www.nricm.edu.tw/twcm/CapabilityStatement/CapabilityStatementTWCMServer Version: 0.1.0
Active as of 2026-10-06 Computable Name: CapabilityStatementTWCMServer

臺灣中醫實作指引(TWCM IG)伺服端(Server)之能力聲明

Raw OpenAPI-Swagger Definition file | Download

臺灣中醫實作指引-伺服端(TWCM Server)

  • 實作指引版本:0.1.0
  • FHIR版本:4.0.1
  • 支援格式:json、xml
  • 發布日:2026-10-06
  • 發布者:衛生福利部國家中醫藥研究所

必須(SHALL)支援以下實作指引

Server的FHIR RESTful功能要求

模式:server

臺灣中醫實作指引-伺服端(TWCM Server)必須(SHALL):
(1)支援本實作指引中所有profiles
(2)根據FHIR規範實作RESTful
(3)回傳狀態碼
   ①(Status 400):無效參數(invalid parameter)
   ②(Status 401/4xx):未經授權的請求(unauthorized request)
   ③(Status 403):未充分授權的資料存取範圍(insufficient permission scope)
   ④(Status 404):未知的resource(unknown resource)
(4)支援JSON格式
(5)可識別每個新增到Server的實例(instance)之meta.profile是否為本實作指引Profiles Defining URL,並確認實例是否依循Profile製作。

臺灣中醫實作指引-伺服端(TWCM Server)建議應該(SHOULD):
(1)支援XML格式。

Resources或Profiles的RESTful功能

Summary

共有十九類Resources,各Resource支援之互動及查詢參數如下表:

Resource型別Profile支援的ProfilesCreateconditionalCreateUpdateconditionalUpdateReadDelete支援的查詢參數
AllergyIntolerance過敏或不耐症(AllergyIntolerance TWCM)-yyyyy--
Bundle中醫-資料交換基本單位(Bundle TWCM)-yyyyy-_id, identifier, composition
CarePlan關懷計畫(CarePlan TWCM)-yyyyy--
ClinicalImpression中醫辨證評估(ClinicalImpression TWCM)-yyyyy--
Composition中醫-臨床文件架構(Composition TWCM)-yyyyy-status, type, subject
Condition-病人主訴(ConditionChiefComplaint TWCM)
病情、問題或診斷(ConditionDiagnosis TWCM)
重大傷病(ConditionMajorIllness TWCM)
病史(ConditionMedicalHistory TWCM)
病人證型(ConditionSyndromeType TWCM)
yyyyy--
DiagnosticReport診斷報告(DiagnosticReport TWCM)-yyyyy--
DocumentReference文件參照(DocumentReference TWCM)-yyyyy--
Encounter就醫事件(Encounter TWCM)-yyyyy--
FamilyMemberHistory家族史(FamilyMemberHistory TWCM)-yyyyy--
Medication藥品(Medication TWCM)-yyyyy--
MedicationRequest中醫-藥品請求(MedicationRequest TWCM)-yyyyy--
Observation-檢驗檢查(Observation TWCM)
血壓(ObservationBloodPressure TWCM)
血型(ObservationBloodtype TWCM)
身高(ObservationBodyHeight TWCM)
體溫(ObservationBodyTemp TWCM)
體重(ObservationBodyWeight TWCM)
教育程度(ObservationEducationLevel TWCM)
脈搏(ObservationHeartRate TWCM)
問診(ObservationInquiry TWCM)
望診(ObservationInspection TWCM)
聞診(ObservationListeningSmelling TWCM)
重大傷病註記(ObservationMajorIllness TWCM)
職業(ObservationOccupation TWCM)
切診(ObservationPalpation TWCM)
病人脈象(ObservationPulseCondition TWCM)
個人史(ObservationSocialHistory TWCM)
生命徵象(ObservationVitalSigns TWCM)
yyyyy--
Organization-醫事機構(Organization TWCM)
檢驗檢查機構(OrganizationInspection TWCM)
yyyyy--
Patient病人資料(Patient TWCM)-yyyyy-identifier, name
Practitioner健康照護服務提供人員資料(Practitioner TWCM)-yyyyy--
Procedure-中醫-處置或手術(Procedure TWCM)
病人治則(ProcedureTherapeuticPrinciples TWCM)
yyyyy--
Provenance醫師簽章(Provenance TWCM)-yyyyy--
ServiceRequest服務請求(ServiceRequest TWCM)-yyyyy--

預期的遵從度:必須(SHALL)AllergyIntolerance
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Bundle
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

查詢參數
遵從度參數類型範例
建議應該(SHOULD)_idtokenGET [base]/Bundle?_id=[id]
GET [base]/Bundle/[id]
建議應該(SHOULD)identifiertokenGET [base]/Bundle?identifier={system|}[code]
建議應該(SHOULD)compositionreferenceGET [base]/Bundle?composition={Type/}[id]
預期的遵從度:必須(SHALL)CarePlan
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)ClinicalImpression
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Composition
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

查詢參數
遵從度參數類型範例
建議應該(SHOULD)statustokenGET [base]/Composition?status=[code]
建議應該(SHOULD)typetokenGET [base]/Composition?type={system|}[code]
建議應該(SHOULD)subjectreferenceGET [base]/Composition?subject={Type/}[id]
預期的遵從度:必須(SHALL)Condition
預期的遵從度:必須(SHALL)DiagnosticReport
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)DocumentReference
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Encounter
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)FamilyMemberHistory
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Medication
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)MedicationRequest
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Organization
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Patient
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

查詢參數
遵從度參數類型範例
建議應該(SHOULD)identifiertokenGET [base]/Patient?identifier={system|}[code]
建議應該(SHOULD)namestringGET [base]/Patient?name=[name]
預期的遵從度:必須(SHALL)Practitioner
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Procedure
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)Provenance
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要

預期的遵從度:必須(SHALL)ServiceRequest
Profile預期的遵從度
必須(SHALL)
支援的參照政策(Reference policy)
resolves

能力摘要