介接約定

照片與附件

需要檔案時提供上傳、關聯與授權下載；格式與期限依院方規格。

1. 上傳檔案#

以下以病人照片為例，使用 multipart/form-data。上傳檔案及所屬病人 ID；院方驗證格式、大小與權限，回傳檔案 ID。其他情境使用對應的資料識別碼。

multipart/form-data · cURL

curl "$HIS_BASE_URL/attachments" \
  -H "Authorization: Bearer $HIS_TOKEN" \
  -F "patientId=P-DEMO-001" \
  -F "file=@wound.jpg;type=image/jpeg"

201 Created

{
  "attachmentId": "F-DEMO-001",
  "patientId": "P-DEMO-001",
  "contentType": "image/jpeg"
}

新增評估請求的附件欄位（節錄）

{
  "patientId": "P-DEMO-001",
  "woundId": "W-DEMO-001",
  "attachmentIds": [
    "F-DEMO-001"
  ]
}

院方驗證檔案、病人與目標紀錄的關聯。Poieti 檔案 ID 與院方檔案 ID 分別管理，由介接層保存對照。

GET/attachments/{attachmentId}/content

下載檔案 · cURL

curl "$HIS_BASE_URL/attachments/F-DEMO-001/content" \
  -H "Authorization: Bearer $HIS_TOKEN" \
  --output wound.jpg

驗證權限後回 200、原始檔案內容及正確的 Content-Type。也可提供有期限的簽名 URL，註明有效期與更新方式。

項目	下載範例的設定／待約定內容
格式、大小	範例接受 JPEG／PNG，單檔最多 10 MiB；院方可調整
讀取	透過授權下載接口或短效簽名 URL；不提供永久公開網址
未綁定檔案	範例上傳後 24 小時未綁定即清除；寫入結果不明時先查原請求結果，再處理檔案
綁定後保存	期限、刪除及作廢規則依院方政策

本例上傳不去重，重送可能產生新檔案 ID；未綁定檔案依期限清除。評估提交逾時時先查原結果，不因重傳照片而重複建立評估。