poieti/developers
實作範例

入院護理評估

入院護理評估的請求、回應與欄位範例。

先完成測試環境設定,準備合成病人及其住院 ID。

1. 核對病人與本次住院#

查詢 · cURL
curl "$HIS_BASE_URL/patients/P-DEMO-001" \
  -H "Authorization: Bearer $HIS_TOKEN"

curl "$HIS_BASE_URL/encounters/V-DEMO-001" \
  -H "Authorization: Bearer $HIS_TOKEN"
200 OK · 本次住院
{
  "encounterId": "V-DEMO-001",
  "patientId": "P-DEMO-001",
  "type": "inpatient",
  "status": "active"
}

核對 patientId 相同、typeinpatient,且住院狀態允許新增評估。encounterId 使用院方就醫清單或測試資料提供的 ID;不以床號作識別鍵。

2. 提交評估#

POST/admission-assessments
admission-assessment.json
{
  "clientRequestId": "REQ-ADMISSION-DEMO-001",
  "patientId": "P-DEMO-001",
  "encounterId": "V-DEMO-001",
  "assessedAt": "2026-09-23T09:20:00+08:00",
  "assessment": {
    "basic": {
      "education": "senior_high",
      "languages": [
        "mandarin",
        "taiwanese_hokkien"
      ],
      "religions": [
        "none"
      ]
    },
    "alerts": {
      "antithromboticUse": "none",
      "drugAllergy": "yes",
      "drugAllergyNote": "合成案例:曾使用盤尼西林後出現皮疹。",
      "drugAllergens": [
        "penicillin"
      ],
      "foodAllergy": "none",
      "transfusionReaction": "unknown",
      "bloodType": "o_positive",
      "recentForeignTravel": "none",
      "treatmentRestrictions": [
        "none"
      ],
      "tubes": [
        "none"
      ],
      "rapidTestDate": {
        "year": 2026,
        "month": 9,
        "day": 23
      },
      "rapidTestResult": "negative",
      "pcrDate": {
        "month": 9,
        "day": 22
      },
      "pcrResult": "negative"
    },
    "health": {
      "familyHistoryStatus": "yes",
      "familyHistory": [
        {
          "relation": "father",
          "diseases": [
            "hypertension"
          ]
        }
      ],
      "maritalStatus": "married",
      "livingStatus": "with_family",
      "familyInteraction": "caring",
      "primaryCaregivers": [
        "spouse"
      ],
      "occupation": "commerce",
      "financialStatus": "comfortable",
      "smokingStatus": "none",
      "alcoholUse": "occasional",
      "betelNutStatus": "none",
      "medicalHistory": [
        "hypertension"
      ],
      "surgeryExperience": "none",
      "recentEmergencyOrAdmissionCount": "none",
      "currentMedications": [
        "antihypertensive"
      ]
    },
    "nutrition": {
      "heightCm": 168,
      "weightKg": 65,
      "edemaStatus": "none",
      "feedingRoutes": [
        "oral"
      ],
      "feedingStatus": [
        "normal"
      ],
      "oralConditions": [
        "normal"
      ],
      "dentures": [
        "none"
      ],
      "dietTypes": [
        "regular"
      ],
      "foodRestriction": "none",
      "otherSymptoms": [
        "none"
      ]
    },
    "sleep": {
      "conditions": [
        "normal"
      ],
      "usualHours": 7
    },
    "activity": {
      "mobility": "walks_with_person_assistance",
      "needsMobilityAid": true,
      "mobilityAids": [
        "walker"
      ],
      "leftUpperMuscleStrength": "5",
      "rightUpperMuscleStrength": "5",
      "leftLowerMuscleStrength": "5",
      "rightLowerMuscleStrength": "4",
      "limbAppearance": "normal",
      "gait": "stable",
      "selfCareAbility": "independent",
      "fallInPastYear": "no"
    },
    "respiratory": {
      "chestSymmetry": "normal",
      "patterns": [
        "normal"
      ],
      "coughFrequency": "none",
      "sputumClearance": "normal",
      "sputumStatus": "none",
      "breathSounds": [
        "normal"
      ],
      "oxygenTherapies": [
        "none"
      ]
    },
    "circulation": {
      "implantStatus": "none",
      "peripheralCirculation": "warm",
      "symptoms": [
        "none"
      ]
    },
    "cognition": {
      "leftVision": [
        "clear"
      ],
      "rightVision": [
        "clear"
      ],
      "leftHearing": [
        "clear"
      ],
      "rightHearing": [
        "clear"
      ],
      "orientation": "fully_oriented",
      "behaviors": [
        "appropriate"
      ],
      "painStatus": "present",
      "painFindings": [
        {
          "site": "lower_limb",
          "score": "4"
        }
      ],
      "speech": "normal",
      "skinAppearance": "normal"
    },
    "elimination": {
      "stoolConditions": [
        "normal"
      ],
      "stoolColor": "normal",
      "urinationConditions": [
        "normal"
      ],
      "urineColor": "normal"
    },
    "reproduction": {
      "maleGenitalAppearance": [
        "normal"
      ]
    },
    "contacts": {
      "decisionMakerName": "測試病人",
      "decisionMakerPhone": "0000000000",
      "decisionMakerRelation": "本人",
      "informationProviderName": "測試病人",
      "informationProviderPhone": "0000000000",
      "informationProviderRelation": "本人",
      "contactName": "測試配偶",
      "contactPhone": "0000000000",
      "contactRelation": "配偶"
    },
    "admission": {
      "wardDate": "2026-09-23",
      "wardTime": "09:00",
      "reason": "合成案例:因右膝疼痛住院,預計接受進一步檢查。"
    },
    "family": {
      "members": [
        {
          "role": "self",
          "sex": "male",
          "age": 62,
          "maritalStatus": "married",
          "isDecisionMaker": "yes",
          "familyHistory": [
            "hypertension"
          ]
        },
        {
          "role": "spouse",
          "sex": "female",
          "age": 60,
          "aliveStatus": "alive",
          "livesTogether": "yes",
          "familyHistory": [
            "none"
          ]
        }
      ]
    }
  }
}

這份合成案例填入所有適用的必填資料,並示範藥物過敏、家族病史、輔具、疼痛及家庭成員。正常/無的值是本測試案例已知資料,不能作為未知資料的預設值。

提交欄位格式/意義
clientRequestId同一次提交的重試保持不變
patientIdencounterId院方病人與本次住院 ID;伺服器驗證所屬關係
assessedAt實際評估時間,ISO 8601 含時區
assessment評估資料;見欄位範例

必填或符合條件的必填資料缺少時回 422;選填未知、不適用與唯讀欄位省略。本例已提供身高體重,因此省略「無法測量原因」。

日期 wardDate 使用 YYYY-MM-DD 字串;快篩/PCR 的部分日期可只傳已知年月日。單選分數是字串,例如疼痛 "4";多選選項標示「只能單獨選擇」時不得混選。

院方需註明同次住院是否允許多筆評估、哪些狀態可新增或更正。

3. 查回紀錄#

201 Created
{
  "clientRequestId": "REQ-ADMISSION-DEMO-001",
  "recordId": "R-ADMISSION-DEMO-001",
  "version": 1,
  "status": "committed",
  "recordState": "valid",
  "recordedAt": "2026-09-23T09:21:00+08:00"
}
以 recordId 查回評估 · cURL
curl "$HIS_BASE_URL/admission-assessments/R-ADMISSION-DEMO-001" \
  -H "Authorization: Bearer $HIS_TOKEN"

GET 回傳提交內容,加上 recordIdversionstatusrecordStaterecordedAt。核對病人、本次住院與各欄位值。

需要更正或作廢時,另提供相應接口與狀態規則,參考寫入與重試

4. 驗證錯誤與重試#

422 Unprocessable Content · 日期格式錯誤
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "請檢查欄位格式。",
    "fields": [
      {
        "path": "assessment.admission.wardDate",
        "message": "請使用 YYYY-MM-DD 字串,例如 \"2026-09-23\"。"
      }
    ]
  },
  "requestId": "TRACE-ADMISSION-DEMO-001"
}

錯誤需指出欄位及可接受格式。病人與住院不符也回 422,且不建立紀錄;無權操作回 403。

提交逾時時查詢 /requests/REQ-ADMISSION-DEMO-001。重送相同 ID 與內容應回原回執,不再新增一筆;相同 ID 搭配不同內容回 409。詳見重試規則

欄位範例#

點開分類查看欄位、代碼與條件。[] 表示陣列中的每一筆;唯讀欄位不放入提交 JSON。

欄位定義 JSON

基本/警訊

基本資料

教育程度assessment.basic.educationstring · 單選必填
代碼顯示值規則
illiterate不識字
elementary小學
junior_high初中
senior_high高中
college專科
university_or_above大學以上
溝通語言assessment.basic.languagesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
mandarin國語
taiwanese_hokkien閩南語
hakka客家語
amis原住民語-阿美
atayal原住民語-泰雅
rukai原住民語-魯凱
yami原住民語-雅美
english外國語-英語
indonesian外國語-印尼語
japanese外國語-日本
thai外國語-泰國語
filipino外國語-菲律賓語
other其它
宗教信仰assessment.basic.religionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
buddhism佛教
taoism道教
christianity基督教
catholicism天主教
islam回教
other其它

警訊/照護問題

抗血栓藥物使用assessment.alerts.antithromboticUsestring · 單選必填
代碼顯示值規則
none
yes
uncertain不詳
藥物過敏assessment.alerts.drugAllergystring · 單選必填
代碼顯示值規則
none
unknown不知道
yes
藥物過敏說明assessment.alerts.drugAllergyNotestring · 長文字條件必填

必填條件:藥物過敏為「有」。

適用條件:藥物過敏為「有」;不符合時省略此欄位。

長度:1–4000 字元

藥物過敏種類assessment.alerts.drugAllergensstring[] · 多選條件必填

必填條件:藥物過敏為「有」。

適用條件:藥物過敏為「有」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
contrast_media顯影劑過敏
blood_transfusion輸血過敏
nsaidNSAID
sulfonamidesSulfonamides
penicillinPenicillin
g6pdG6PD
other其他
其他藥物過敏assessment.alerts.otherDrugAllergenstring · 文字條件必填

必填條件:藥物過敏種類包含「其他」。

適用條件:藥物過敏種類包含「其他」;不符合時省略此欄位。

長度:1–500 字元

食物過敏assessment.alerts.foodAllergystring · 單選必填
代碼顯示值規則
none
unknown不知道
yes
食物過敏種類assessment.alerts.foodAllergensstring[] · 多選條件必填

必填條件:食物過敏為「有」。

適用條件:食物過敏為「有」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
seafood海鮮類
mushroom菇類
beef牛肉
other其它
輸血反應assessment.alerts.transfusionReactionstring · 單選必填
代碼顯示值規則
none
unknown不知道
yes
血型assessment.alerts.bloodTypestring · 單選必填
代碼顯示值規則
o_positiveO+
a_positiveA+
b_positiveB+
ab_positiveAB+
o_negativeO-
a_negativeA-
b_negativeB-
ab_negativeAB-
unknown不知道
近 3 個月外國旅遊史assessment.alerts.recentForeignTravelstring · 單選必填
代碼顯示值規則
none
yes
旅遊地點assessment.alerts.travelLocationstring · 文字條件必填

必填條件:近 3 個月外國旅遊史為「有」。

適用條件:近 3 個月外國旅遊史為「有」;不符合時省略此欄位。

長度:1–500 字元

禁做治療assessment.alerts.treatmentRestrictionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
left_hand左手
right_hand右手
left_foot左腳
right_foot右腳
other其它
管路assessment.alerts.tubesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
ngNG
foleyFoley
tracheostomy氣切
pigtailpigtail
port_aport-A
av_shuntAV shunt
other其它
快篩日期assessment.alerts.rapidTestDateobject · 部分日期選填

{"month":9,"day":22};只傳已知的 year、month、day 整數,不能是空物件。已知月日需通過日曆驗證。

快篩結果assessment.alerts.rapidTestResultstring · 單選選填
代碼顯示值規則
positivePositive
negativeNegative
PCR 日期assessment.alerts.pcrDateobject · 部分日期選填

{"month":9,"day":22};只傳已知的 year、month、day 整數,不能是空物件。已知月日需通過日曆驗證。

PCR 結果assessment.alerts.pcrResultstring · 單選選填
代碼顯示值規則
positivePositive
negativeNegative
CT 值assessment.alerts.pcrCtValuenumber條件必填

必填條件:PCR 結果為「Positive」。

適用條件:PCR 結果為「Positive」;不符合時省略此欄位。

數值:0–50

健康/家庭

家庭健康史

家族病史assessment.health.familyHistoryStatusstring · 單選必填
代碼顯示值規則
none
yes
uncertain不詳
各親屬家族病史assessment.health.familyHistoryobject[] · 重複資料列條件必填

必填條件:家族病史為「有」。

適用條件:家族病史為「有」;不符合時省略此欄位。

資料列:1–50 筆

每筆資料列的子欄位

發病親屬assessment.health.familyHistory[].relationstring · 單選必填
代碼顯示值規則
father
mother
son
daughter
paternal_grandfather祖父
paternal_grandmother祖母
other其他
疾病assessment.health.familyHistory[].diseasesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
hypertension高血壓
heart_disease心臟病
diabetes糖尿病
liver_cancer肝癌
colorectal_cancer大腸直腸癌
asthma氣喘
blood_disease血液病
cancer癌症
cerebrovascular_disease腦血管疾病
mental_illness精神疾病
other其它

家庭與社會狀況

婚姻狀況assessment.health.maritalStatusstring · 單選必填
代碼顯示值規則
single未婚
married已婚
divorced離婚
separated分居
cohabiting同居
widowed喪偶
居住狀況assessment.health.livingStatusstring · 單選必填
代碼顯示值規則
spouse_only僅有配偶同住
with_family與家人同住
alone_family_support獨居且有家屬協助
alone_friend_support獨居且有朋友協助
alone_independent獨居且無人協助但能自理
alone_dependent獨居且無人協助且無法自理
care_facility住護理之家或療養機構
other其它
與家人互動關係assessment.health.familyInteractionstring · 單選必填
代碼顯示值規則
caring互相關懷
distant疏離
no_contact不相往來
other其他
其它互動關係assessment.health.otherFamilyInteractionstring · 文字條件必填

必填條件:與家人互動關係為「其他」。

適用條件:與家人互動關係為「其他」;不符合時省略此欄位。

長度:1–500 字元

住院期間主要照顧者assessment.health.primaryCaregiversstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
spouse配偶
parents父母
children子女
friends朋友
caregiver看護
foreign_caregiver外傭
other其他
其它主要照顧者assessment.health.otherPrimaryCaregiverstring · 文字條件必填

必填條件:住院期間主要照顧者包含「其他」。

適用條件:住院期間主要照顧者包含「其他」;不符合時省略此欄位。

長度:1–500 字元

職業別assessment.health.occupationstring · 單選必填
代碼顯示值規則
none
military軍人
civil_service
education
industrial
commerce
agriculture
student學生
healthcare醫護
service服務業
other其它
其它職業assessment.health.otherOccupationstring · 文字條件必填

必填條件:職業別為「其它」。

適用條件:職業別為「其它」;不符合時省略此欄位。

長度:1–500 字元

經濟狀況assessment.health.financialStatusstring · 單選必填
代碼顯示值規則
affluent富裕
comfortable小康
barely_sustaining勉強維持生活
low_income低收入戶

健康行為

抽菸狀態assessment.health.smokingStatusstring · 單選必填
代碼顯示值規則
none
current
quitting_under_six_months持續戒菸中未達半年
quit_six_months_or_more已戒達半年以上
抽菸量assessment.health.smokingAmountnumber條件必填

必填條件:抽菸狀態不是「無」。

適用條件:抽菸狀態不是「無」;不符合時省略此欄位。

數值:0–1000

抽菸量單位assessment.health.smokingAmountUnitstring · 單選條件必填

必填條件:抽菸狀態不是「無」。

適用條件:抽菸狀態不是「無」;不符合時省略此欄位。

代碼顯示值規則
packs_per_day包/天
cigarettes_per_day支/天
開始吸菸至今assessment.health.smokingYearsnumber條件必填

必填條件:抽菸狀態不是「無」。

適用條件:抽菸狀態不是「無」;不符合時省略此欄位。

單位:年

數值:0–120

戒菸經驗assessment.health.quitSmokingExperiencestring · 單選條件必填

必填條件:抽菸狀態不是「無」。

適用條件:抽菸狀態不是「無」;不符合時省略此欄位。

代碼顯示值規則
none
yes
戒菸意願assessment.health.quitSmokingWillingnessstring · 單選條件必填

必填條件:抽菸狀態不是「無」。

適用條件:抽菸狀態不是「無」;不符合時省略此欄位。

代碼顯示值規則
yes
no
喝酒assessment.health.alcoholUsestring · 單選必填
代碼顯示值規則
none
quit已戒
occasional偶爾(應酬)
frequent經常
daily每天
檳榔狀態assessment.health.betelNutStatusstring · 單選必填
代碼顯示值規則
none
quit已戒
current
檳榔量assessment.health.betelNutAmountnumber條件必填

必填條件:檳榔狀態不是「無」。

適用條件:檳榔狀態不是「無」;不符合時省略此欄位。

單位:包/天

數值:0–1000

開始嚼檳榔至今assessment.health.betelNutYearsnumber條件必填

必填條件:檳榔狀態不是「無」。

適用條件:檳榔狀態不是「無」;不符合時省略此欄位。

單位:年

數值:0–120

過去病史、就醫與用藥

過去病史assessment.health.medicalHistorystring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
breast_cancer乳癌
blood_disease血液病
mental_illness精神疾病
hypertension高血壓
liver_cancer肝癌
cancer癌症
heart_disease心臟病
colorectal_cancer大腸直腸癌
suicide自殺
diabetes糖尿病
asthma氣喘
cerebrovascular_disease腦血管病變
other其它
手術經驗assessment.health.surgeryExperiencestring · 單選必填
代碼顯示值規則
none
yes
手術說明assessment.health.surgeryNotestring · 文字條件必填

必填條件:手術經驗為「有」。

適用條件:手術經驗為「有」;不符合時省略此欄位。

長度:1–500 字元

近 3 個月急診或住院次數assessment.health.recentEmergencyOrAdmissionCountstring · 單選必填
代碼顯示值規則
none沒有
one1 次
two2 次
more_than_two>2 次
現在用藥assessment.health.currentMedicationsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
antidepressant_or_antipsychotic抗憂鬱/抗精神病藥
cardiac心臟用藥
laxative_or_stool_softener瀉藥/軟便劑
antihypertensive降血壓
antiepileptic抗癲癇藥
anticoagulant抗凝血劑
anesthetic_analgesic麻醉止痛藥
glucose_lowering降血糖
anti_parkinson抗帕金森氏症藥
erythropoietin紅血球生成素
muscle_relaxant肌肉鬆弛劑
diuretic利尿劑
oral_anticancer口服抗癌藥物
sedative_hypnotic鎮靜安眠藥
other其它
營養/睡眠

營養代謝

身高assessment.nutrition.heightCmnumber選填

單位:公分

數值:20–250

體重assessment.nutrition.weightKgnumber選填

單位:Kg

數值:0.5–500

理想體重assessment.nutrition.idealWeightKg唯讀計算值唯讀

單位:Kg

提交時省略;院方需定義回傳型別與計算/產生方式。

身高體重無法測量原因assessment.nutrition.measurementUnavailableReasonstring · 文字條件必填

必填條件:(身高未提供) 或 (體重未提供)。

適用條件:(身高未提供) 或 (體重未提供);不符合時省略此欄位。

長度:1–500 字元

相較理想體重assessment.nutrition.relativeIdealWeight唯讀計算值唯讀

適用條件:(身高已提供) 且 (體重已提供);不符合時省略此欄位。

提交時省略;院方需定義回傳型別與計算/產生方式。

水腫情形assessment.nutrition.edemaStatusstring · 單選必填
代碼顯示值規則
none
present
水腫部位與程度assessment.nutrition.edemaFindingsobject[] · 重複資料列條件必填

必填條件:水腫情形為「有」。

適用條件:水腫情形為「有」;不符合時省略此欄位。

資料列:1–50 筆

每筆資料列的子欄位

部位assessment.nutrition.edemaFindings[].sitestring · 單選必填
代碼顯示值規則
left_upper_limb左上肢
right_upper_limb右上肢
left_lower_limb左下肢
right_lower_limb右下肢
both_upper_limbs雙上肢
both_lower_limbs雙下肢
all_limbs四肢
程度assessment.nutrition.edemaFindings[].severitystring · 選項必填
代碼顯示值規則
grade_11+
grade_22+
grade_33+
grade_44+
進食方式assessment.nutrition.feedingRoutesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
oral由口進食
ng_feedingN-G Feeding
gastrostomy胃造
enterostomy腸造
tpn_ppnTPN/PPN
other其它
進食情況assessment.nutrition.feedingStatusstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
decreased_appetite食慾減低
dysphagia吞嚥困難
chewing_difficulty咀嚼困難
npo禁食
other其它
口腔狀況assessment.nutrition.oralConditionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
mucosal_damage黏膜破損
oral_odor口腔異味
other其它
假牙assessment.nutrition.denturesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
upper
lower
上假牙類型assessment.nutrition.upperDentureTypestring · 單選條件必填

必填條件:假牙包含「上」。

適用條件:假牙包含「上」;不符合時省略此欄位。

代碼顯示值規則
fixed固定
removable活動
下假牙類型assessment.nutrition.lowerDentureTypestring · 單選條件必填

必填條件:假牙包含「下」。

適用條件:假牙包含「下」;不符合時省略此欄位。

代碼顯示值規則
fixed固定
removable活動
飲食種類assessment.nutrition.dietTypesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
regular普通飲食
tube_feeding管灌
vegetarian素食
special特殊飲食
other其他
素食細項assessment.nutrition.vegetarianDietDetailsstring[] · 多選條件必填

必填條件:飲食種類包含「素食」。

適用條件:飲食種類包含「素食」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
soft軟質
liquid流質
diabetic糖尿病
low_fat低油
low_salt低鹽
特殊飲食細項assessment.nutrition.specialDietDetailsstring[] · 多選條件必填

必填條件:飲食種類包含「特殊飲食」。

適用條件:飲食種類包含「特殊飲食」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
soft軟質
liquid流質
diabetic糖尿病
low_fat低油
low_salt低鹽
其它飲食assessment.nutrition.otherDietstring · 文字條件必填

必填條件:飲食種類包含「其他」。

適用條件:飲食種類包含「其他」;不符合時省略此欄位。

長度:1–500 字元

食物禁忌assessment.nutrition.foodRestrictionstring · 單選必填
代碼顯示值規則
none
yes
食物禁忌說明assessment.nutrition.foodRestrictionNotestring · 文字條件必填

必填條件:食物禁忌為「有」。

適用條件:食物禁忌為「有」;不符合時省略此欄位。

長度:1–500 字元

其它症狀assessment.nutrition.otherSymptomsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
nausea噁心
vomiting嘔吐
hiccups打嗝
bloating腹脹

休息睡眠

休息睡眠狀況assessment.sleep.conditionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
day_night_reversal日夜顛倒
insomnia失眠
fatigue倦怠
other其它
平時約入睡幾小時assessment.sleep.usualHoursnumber必填

單位:小時

數值:0–24

活動/運動

活動運動

活動能力assessment.activity.mobilitystring · 單選必填
代碼顯示值規則
unable_to_walk無法自行走動
walks_with_person_assistance可走動需他人協助
independent自己可走動
可走動需輔助協助assessment.activity.needsMobilityAidboolean必填
行動輔具assessment.activity.mobilityAidsstring[] · 多選條件必填

必填條件:可走動需輔助協助為「是」。

適用條件:可走動需輔助協助為「是」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
cane拐杖
walker助行器
wheelchair輪椅
prosthesis義肢
mobile_commode活動便盆椅
mobile_iv_stand活動點滴架
other其他
其它行動輔具assessment.activity.otherMobilityAidstring · 文字條件必填

必填條件:行動輔具包含「其他」。

適用條件:行動輔具包含「其他」;不符合時省略此欄位。

長度:1–500 字元

左上肢肌肉張力assessment.activity.leftUpperMuscleStrengthstring · 選項必填
代碼顯示值規則
00 分
11 分
22 分
33 分
44 分
55 分
右上肢肌肉張力assessment.activity.rightUpperMuscleStrengthstring · 選項必填
代碼顯示值規則
00 分
11 分
22 分
33 分
44 分
55 分
左下肢肌肉張力assessment.activity.leftLowerMuscleStrengthstring · 選項必填
代碼顯示值規則
00 分
11 分
22 分
33 分
44 分
55 分
右下肢肌肉張力assessment.activity.rightLowerMuscleStrengthstring · 選項必填
代碼顯示值規則
00 分
11 分
22 分
33 分
44 分
55 分
外觀-肢體assessment.activity.limbAppearancestring · 單選必填
代碼顯示值規則
normal正常
abnormal異常
步態assessment.activity.gaitstring · 單選必填
代碼顯示值規則
stable穩定
unstable不穩定
不穩定步態細項assessment.activity.unstableGaitDetailsstring[] · 多選條件必填

必填條件:步態為「不穩定」。

適用條件:步態為「不穩定」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
left_hemiplegia偏癱(左側)
right_hemiplegia偏癱(右側)
limp跛行
unable_to_assess暫無法評估
other其他
其它步態assessment.activity.otherGaitstring · 文字條件必填

必填條件:不穩定步態細項包含「其他」。

適用條件:不穩定步態細項包含「其他」;不符合時省略此欄位。

長度:1–500 字元

自我照顧能力assessment.activity.selfCareAbilitystring · 單選必填
代碼顯示值規則
independent日常生活獨立
needs_help需他人協助
需協助項目assessment.activity.selfCareAssistancestring[] · 多選條件必填

必填條件:自我照顧能力為「需他人協助」。

適用條件:自我照顧能力為「需他人協助」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
eating進食
dressing穿衣
bathing沐浴
toileting如廁
transfer移位
medication服藥
cooking煮飯
finances處理財物
shopping購物
going_out外出
最近一年內曾發生跌倒assessment.activity.fallInPastYearstring · 單選必填
代碼顯示值規則
yes
no
uncertain不詳

氣循環

胸廓對稱性assessment.respiratory.chestSymmetrystring · 單選必填
代碼顯示值規則
normal正常
abnormally_symmetric不正常對稱
呼吸型態assessment.respiratory.patternsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
labored費力
orthopnea端坐喘息
accessory_muscle_use使用呼吸輔助肌
ventilator_use使用呼吸器
咳嗽assessment.respiratory.coughFrequencystring · 單選必填
代碼顯示值規則
none
occasional偶爾
frequent經常
咳痰能力assessment.respiratory.sputumClearancestring · 單選必填
代碼顯示值規則
normal正常
needs_assistance需協助咳痰
suction抽痰
痰液assessment.respiratory.sputumStatusstring · 單選必填
代碼顯示值規則
none
yes
痰液顏色assessment.respiratory.sputumColorstring · 單選條件必填

必填條件:痰液為「有」。

適用條件:痰液為「有」;不符合時省略此欄位。

代碼顯示值規則
yellow黃色
white白色
red紅色
rust鐵銹色
痰液黏稠度assessment.respiratory.sputumViscositystring · 單選條件必填

必填條件:痰液為「有」。

適用條件:痰液為「有」;不符合時省略此欄位。

代碼顯示值規則
thin
thick
痰液量assessment.respiratory.sputumAmountstring · 單選條件必填

必填條件:痰液為「有」。

適用條件:痰液為「有」;不符合時省略此欄位。

代碼顯示值規則
large
medium
small
呼吸聲assessment.respiratory.breathSoundsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
diminished減弱
rhonchi囉音 rhonch I
wheezing喘鳴音 wheezing
stridor摩擦音 stridor
用氧情況assessment.respiratory.oxygenTherapiesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
nasal_cannulaNasal cannula
maskMask
ventilatorventilator
peepPEEP
fio2FIO2
tracheostomy氣切
other其它
人工置入物assessment.circulation.implantStatusstring · 單選必填
代碼顯示值規則
none
yes
人工置入物種類assessment.circulation.implantTypesstring[] · 多選條件必填

必填條件:人工置入物為「有」。

適用條件:人工置入物為「有」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
pacemakerpacemaker
metal_valve金屬瓣膜置換
末梢循環assessment.circulation.peripheralCirculationstring · 單選必填
代碼顯示值規則
warm溫暖
cold冰冷
other其它
病徵assessment.circulation.symptomsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
none只能單獨選擇
palpitations心悸
clubbing杵狀指
jugular_venous_distention頸靜脈怒張
epigastric_burning上腹灼熱
chest_tightness胸悶
dizziness頭暈(含暈厥及眩暈)
other其它
認知/感受

認知知覺

視力(左)assessment.cognition.leftVisionstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
clear清晰只能單獨選擇
blind失明
presbyopia老花眼
myopia近視
diplopia複視
amblyopia弱視
hemianopia偏盲
cataract白內障
glaucoma青光眼
other其它
視力(右)assessment.cognition.rightVisionstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
clear清晰只能單獨選擇
blind失明
presbyopia老花眼
myopia近視
diplopia複視
amblyopia弱視
hemianopia偏盲
cataract白內障
glaucoma青光眼
other其它
聽力(左)assessment.cognition.leftHearingstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
clear清晰只能單獨選擇
hard_of_hearing重聽
deaf失聰
tinnitus耳鳴
hearing_aid助聽器
cochlear_implant電子耳
other其它
聽力(右)assessment.cognition.rightHearingstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
clear清晰只能單獨選擇
hard_of_hearing重聽
deaf失聰
tinnitus耳鳴
hearing_aid助聽器
cochlear_implant電子耳
other其它
意識-認知能力assessment.cognition.orientationstring · 單選必填
代碼顯示值規則
fully_oriented清醒且對人時地物認知正確
sometimes_partially_disoriented一天中某些時間失去部份定向感
always_partially_disoriented一天中所有時間失去部份定向感
sometimes_fully_disoriented一天中某些時間失去全部定向感
always_fully_disoriented一天中所有時間失去全部定向感
coma昏迷
意識-行為型態assessment.cognition.behaviorsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
appropriate適當只能單獨選擇
wandering四處游走
restless燥動不安
confused混亂
other其它
疼痛狀態assessment.cognition.painStatusstring · 單選必填
代碼顯示值規則
none
present
unable_to_assess無法評估
疼痛部位與分數assessment.cognition.painFindingsobject[] · 重複資料列條件必填

必填條件:疼痛狀態為「有」。

適用條件:疼痛狀態為「有」;不符合時省略此欄位。

資料列:1–50 筆

每筆資料列的子欄位

部位assessment.cognition.painFindings[].sitestring · 單選必填
代碼顯示值規則
head頭部
tooth
mouth口腔
eye眼睛
ear耳朵
neck頸部
back背部
chest胸部
abdomen腹部
waist腰部
upper_limb上肢
lower_limb下肢
other其他
疼痛分數assessment.cognition.painFindings[].scorestring · 選項必填
代碼顯示值規則
00 分
11 分
22 分
33 分
44 分
55 分
66 分
77 分
88 分
99 分
1010 分
其它疼痛部位assessment.cognition.painFindings[].otherSitestring · 文字條件必填

必填條件:部位為「其他」。

適用條件:部位為「其他」;不符合時省略此欄位。

長度:1–500 字元

語言表達assessment.cognition.speechstring · 單選必填
代碼顯示值規則
normal正常
unclear_articulation口齒欠清
speech_disorder語言障礙
aphasia失語症
other其它
皮膚外觀assessment.cognition.skinAppearancestring · 單選必填
代碼顯示值規則
normal正常
abnormal異常
other其它
皮膚問題與部位assessment.cognition.skinFindingsobject[] · 重複資料列條件必填

必填條件:皮膚外觀為「異常」。

適用條件:皮膚外觀為「異常」;不符合時省略此欄位。

資料列:1–50 筆

每筆資料列的子欄位

皮膚問題類型assessment.cognition.skinFindings[].typestring · 單選必填
代碼顯示值規則
pallor蒼白
rash紅疹
blister水泡
swelling紅腫
ulcer潰瘍
jaundice黃疸
wound傷口
peeling脫皮
cracking乾裂
發生部位assessment.cognition.skinFindings[].sitesstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
face臉部
eyelid眼瞼
mouth口腔
neck頸部
back背部
chest胸部
abdomen腹部
waist腰部
upper_limb上肢
lower_limb下肢
other其它
生殖/排泄

生理評估-排泄

大便狀況assessment.elimination.stoolConditionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
incontinence失禁
constipation便秘
diarrhea腹瀉
colostomy人工肛門
other其它
大便顏色assessment.elimination.stoolColorstring · 單選必填
代碼顯示值規則
normal正常
bloody血便
black黑便
clay黏土色
gray_white灰白便
other其它
小便狀況assessment.elimination.urinationConditionsstring[] · 多選必填

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
incontinence失禁
nocturia夜尿
frequency頻尿
difficulty排尿困難
dysuria解尿疼痛
oliguria尿少
renal_stoma人工造瘻-腎
bladder_stoma人工造瘻-膀胱
indwelling_catheter導尿-存留導尿
intermittent_catheter導尿-間歇導尿
other其它
尿液顏色assessment.elimination.urineColorstring · 單選必填
代碼顯示值規則
normal正常
tea茶色
cloudy混濁
bloody血尿
other其它
其它症狀assessment.elimination.otherSymptomsstring[] · 多選選填

不重複;至少 0 項

代碼顯示值規則
hematemesis吐血
profuse_sweating大量出汗
ascites腹水

性生殖

生殖器外觀(男)assessment.reproduction.maleGenitalAppearancestring[] · 多選條件必填

必填條件:病人性別為「男性」。

適用條件:病人性別為「男性」;不符合時省略此欄位。

不重複;至少 1 項

代碼顯示值規則
normal正常只能單獨選擇
abnormal_discharge異常分泌物
enlarged_prostate攝護腺腫大
other其它

資料提供者

醫療措施決策者姓名assessment.contacts.decisionMakerNamestring · 文字必填

長度:1–500 字元

醫療措施決策者電話assessment.contacts.decisionMakerPhonestring · 文字必填

長度:6–20 字元

格式:^[0-9+()\-\s]{6,20}$

醫療措施決策者稱謂/關係assessment.contacts.decisionMakerRelationstring · 文字必填

長度:1–500 字元

資料提供者姓名assessment.contacts.informationProviderNamestring · 文字必填

長度:1–500 字元

資料提供者電話assessment.contacts.informationProviderPhonestring · 文字必填

長度:6–20 字元

格式:^[0-9+()\-\s]{6,20}$

資料提供者與病人關係assessment.contacts.informationProviderRelationstring · 文字必填

長度:1–500 字元

聯絡人姓名assessment.contacts.contactNamestring · 文字必填

長度:1–500 字元

聯絡人電話assessment.contacts.contactPhonestring · 文字必填

長度:6–20 字元

格式:^[0-9+()\-\s]{6,20}$

聯絡人電話 2assessment.contacts.contactPhone2string · 文字選填

長度:6–20 字元

格式:^[0-9+()\-\s]{6,20}$

聯絡人稱謂/關係assessment.contacts.contactRelationstring · 文字必填

長度:1–500 字元

住院原因

住院原因

入住病房日期assessment.admission.wardDatestring · 日期必填

YYYY-MM-DD,例如 "2026-09-23"

入住病房時間assessment.admission.wardTimestring · 時間必填

24 小時 HH:mm,例如 "09:00";本例使用 Asia/Taipei

住院原因assessment.admission.reasonstring · 長文字必填

長度:1–8000 字元

家庭關係

家庭成員

家庭成員assessment.family.membersobject[] · 重複資料列選填

資料列:0–50 筆

最多一位 role=self;本人不填 aliveStatus。病人性別條件在本例取自本人的 sex,院方需與病人資料核對。

每筆資料列的子欄位

成員 IDassessment.family.members[].memberId唯讀計算值唯讀

提交時省略;院方需定義回傳型別與計算/產生方式。

成員身份assessment.family.members[].rolestring · 單選必填
代碼顯示值規則
self本人
spouse配偶
father爸爸
mother媽媽
paternal_grandfather祖父
paternal_grandmother祖母
maternal_grandfather外祖父
maternal_grandmother外祖母
older_brother哥哥
older_sister姐姐
younger_brother弟弟
younger_sister妹妹
son兒子
daughter_in_law媳婦
daughter女兒
son_in_law女婿
fetus懷孕胞胎
grandson孫子
grandson_spouse孫媳婦
granddaughter孫女
granddaughter_spouse孫女婿
maternal_grandson外孫
maternal_grandson_spouse外孫媳婦
maternal_granddaughter外孫女
maternal_granddaughter_spouse外孫女婿
stepfather繼父
stepmother繼母
adoptive_father養父
adoptive_mother養母
adopted_son養子
adopted_daughter養女
other其他
其他成員身份assessment.family.members[].otherRolestring · 文字條件必填

必填條件:成員身份為「其他」。

適用條件:成員身份為「其他」;不符合時省略此欄位。

長度:1–500 字元

存歿狀態assessment.family.members[].aliveStatusstring · 單選選填

適用條件:成員身份不是「本人」;不符合時省略此欄位。

代碼顯示值規則
alive存活
deceased死亡
家庭決策者assessment.family.members[].isDecisionMakerstring · 單選選填
代碼顯示值規則
yes
no
同住assessment.family.members[].livesTogetherstring · 單選選填
代碼顯示值規則
yes
no
排行assessment.family.members[].birthOrdernumber選填

數值:1–30;僅限整數

年齡assessment.family.members[].agenumber選填

單位:歲

數值:0–130;僅限整數

性別assessment.family.members[].sexstring · 單選選填
代碼顯示值規則
male男性
female女性
unknown性別不明
胞胎assessment.family.members[].multipleBirthstring · 單選選填
代碼顯示值規則
yes
no
婚姻assessment.family.members[].maritalStatusstring · 單選選填
代碼顯示值規則
single未婚
married已婚
divorced離婚
separated分居
cohabiting同居
widowed喪偶
家族病史assessment.family.members[].familyHistorystring[] · 多選選填

不重複;至少 0 項

代碼顯示值規則
none只能單獨選擇
hypertension高血壓
heart_disease心臟病
diabetes糖尿病
liver_cancer肝癌
colorectal_cancer大腸直腸癌
asthma氣喘
blood_disease血液病
cancer癌症
cerebrovascular_disease腦血管疾病
mental_illness精神疾病
other其它
其他病史assessment.family.members[].otherMedicalHistorystring · 文字條件必填

必填條件:家族病史包含「其它」。

適用條件:家族病史包含「其它」;不符合時省略此欄位。

長度:1–500 字元

備註assessment.family.members[].notestring · 長文字選填

長度:1–4000 字元

Poieti · HIS 介接設計範例 v0.1

搜尋文件

OpenAPI 範例