介接約定

查詢資料

病人查詢、篩選條件與分頁格式。

病人查詢#

GET/patients/{patientId}

200 OK

{
  "patientId": "P-DEMO-001",
  "medicalRecordNumber": "DEMO-001",
  "displayName": "測試病人"
}

用院方識別碼查詢。姓名搜尋回候選清單與核對資訊，不自動選第一筆；病歷號需連同機構解讀。範例中，單筆不存在回 404，查詢清單無符合結果則回 200 與空陣列。

GET/patients/{patientId}/wounds?cursor=…

200 OK · 傷口清單範例

{
  "items": [
    {
      "woundId": "W-DEMO-001",
      "patientId": "P-DEMO-001",
      "site": "左小腿"
    }
  ],
  "nextCursor": null
}

此範例每頁最多 50 筆，按 woundId 升冪；首次省略 cursor。nextCursor: null 表示最後一頁，沒有資料時回 items: []。

實際清單請列出支援的篩選條件、排序、筆數上限；有快取或延遲時，回傳資料更新時間。

這些條件用來縮小查詢，不能取代權限檢查。Poieti 只使用接口實際回傳的 ID，不自行產生院方識別碼。