實作範例

新增傷口評估

POST /wound-assessments 的請求、回應與結果查詢。

先完成測試環境設定。院方需預先建立合成病人與既有傷口；以下 ID 及照片檔案請換成測試環境的資料。

1. 查病人與既有傷口#

查詢 · cURL

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

curl "$HIS_BASE_URL/patients/P-DEMO-001/wounds" \
  -H "Authorization: Bearer $HIS_TOKEN"

P-DEMO-001 與 W-DEMO-001 取自查詢結果。本例的就醫 ID V-DEMO-001 由院方就醫查詢取得；若流程不需就醫關聯則省略。新傷口要先走院方的建立流程。

2. 上傳照片#

依附件接口上傳照片，取得 F-DEMO-001。以下均為合成測試資料。

3. 提交評估#

POST/wound-assessments

wound-assessment.json

{
  "clientRequestId": "REQ-DEMO-001",
  "patientId": "P-DEMO-001",
  "encounterId": "V-DEMO-001",
  "woundId": "W-DEMO-001",
  "observedAt": "2026-09-23T09:30:00+08:00",
  "assessment": {
    "length": {
      "value": 2,
      "unit": "cm"
    },
    "width": {
      "value": 1,
      "unit": "cm"
    },
    "careNote": "本次已清潔並更換敷料。"
  },
  "attachmentIds": [
    "F-DEMO-001"
  ]
}

提交 JSON 檔案

curl "$HIS_BASE_URL/wound-assessments" \
  -H "Authorization: Bearer $HIS_TOKEN" \
  -H "Content-Type: application/json" \
  --data @wound-assessment.json

範例欄位	本例必填	來源／格式
`clientRequestId`	是	呼叫方產生；同一次提交的重試保持不變
`patientId`／`woundId`	是	院方查詢結果
`encounterId`	依流程	院方就醫 ID；不適用就省略
`observedAt`	是	實際評估時間，ISO 8601 含時區
`assessment.careNote`	是	處置描述
`assessment.length`／`width`	否	有量測才填；數值 + cm
`attachmentIds`	是	已上傳的院方檔案 ID；無照片時傳 []

4. 查回正式紀錄#

201 Created

{
  "clientRequestId": "REQ-DEMO-001",
  "recordId": "R-DEMO-001",
  "version": 1,
  "status": "committed",
  "recordState": "valid",
  "recordedAt": "2026-09-23T09:31:00+08:00"
}

用 recordId 查回內容

curl "$HIS_BASE_URL/wound-assessments/R-DEMO-001" \
  -H "Authorization: Bearer $HIS_TOKEN"

核對病人、傷口、評估內容及照片。若提交逾時，先查 /requests/REQ-DEMO-001；需要重試時沿用原請求 ID。

驗收案例