動作
任務 #11532
進行中
概述
串接文件如附件
API欄位代表意思：
合作計畫代號→社群(院區)
服務單位編碼/名稱→單位
服務站編碼/名稱→站
硬體型號→不是需要的資訊
※量測點的區域：
社群（院區）-＞單位-＞站
※區域參數(e.g.)：
A -> A1 ->001
檔案
由 Sam Wang 於 3 天 前更新
注意¶
尚待廠商介接測試
-
提供廠商登入帳密: chilinemd/chilinemd168(或是廠商提供我來建立)
-
請廠商提供: AES KEY
使用者與設備運用並接入我方系統流程還是要了解清楚，對於系統數據目前採既有方式，此部分有可能異動，儲存資料與設計有可能變更。
appsettings.json¶
{
"AppSettings": {
"TelecareConfig": {
"IsEnabled": false, // 啟用支援全家寶端點
"AesKey": "",
"EcgBasePath": "\\\\192.168.2.1\\share\\ECG\\", // 儲存解碼得到JPG進行儲存
"EcgRelativeBase": "ecg"
}
}
}
EcgBasePath: 是給後端程式看的「真實物理門牌」（例如：\NAS\ECG_Storage\）。
EcgRelativeBase: 是給前端與 API 校驗用的「虛擬分類代碼」（例如：ecg）。
全家寶量測數據接收端點 (POST)¶
1. 核心量測端點¶
| 量測類別 | API 端點 (URL 路徑) | 關鍵數據欄位 |
|---|---|---|
| 血壓 | POST /api/telecare/InsBP |
收縮壓 (SBP)、舒張壓 (DBP)、脈搏 (P) |
| 血糖 | POST /api/telecare/InsGlucose |
血糖值 (AC/PC/NM)、體重 (BODY) |
| 心電圖 (ECG) | POST /api/telecare/InsECG |
MeasurementEcgRecords |
| 血氧/呼吸/心率 | POST /api/telecare/InsS68 |
血氧 (BO)、呼吸率 (RR)、心率 (HR) |
| 體溫 | POST /api/telecare/InsTemp |
體溫 (TMP) |
2. 其他生理量測端點¶
| 量測類別 | API 端點 (URL 路徑) | 關鍵數據欄位 |
|---|---|---|
| 體脂/基礎健康 | POST /api/telecare/InsBodyFat |
體脂率 (BFP)、肌肉量 (MUSL)、骨量 (BONE) 等 |
| 尿酸 | POST /api/telecare/InsUricAcid |
尿酸值 (UA) |
| 總膽固醇 | POST /api/telecare/InsCholesterol |
總膽固醇 (TC) |
| 腰圍 | POST /api/telecare/InsWaist |
腰圍 (WC) |
| 每日步數 | POST /api/telecare/InsDailyStep |
總步數 (STP) |
3. 資源輔助端點¶
| 功能 | API 端點 (URL 路徑) | 方法 | 描述 |
|---|---|---|---|
| ECG 圖片調取 | /api/telecare/ecg-image |
GET |
透過相對路徑從 NAS 讀取並顯示心電圖 JPG |
附註：
- 列表查詢 API：
/api/measurement-record/list已整合上述所有數據（含 ECG 虛擬紀錄）。 - 列表查詢 API：
/api/v2/health-measure-info/typelist已整合上述所有數據（含 ECG 虛擬紀錄）。
4. API 端點與數據代碼對照表 (MeasurementRecords)¶
除 ECG 儲存於獨立資料表 MeasurementEcgRecords 外，其餘數據均儲存於 [MeasurementRecords]表中：
| 功能名稱 | API 端點 (POST) | 數據代碼 (Code) | 備註 |
|---|---|---|---|
| 血壓量測 | /api/telecare/InsBP |
SBP, DBP, P
|
收縮壓、舒張壓、脈搏 |
| 血糖量測 | /api/telecare/InsGlucose |
AC, PC, NM
|
依 GluType 映射，其餘為 NM |
| 身高體重 BMI | /api/telecare/InsUserBody |
BMI |
可使用 /InsWeight 副本端點 |
| 心電圖 (ECG) | /api/telecare/InsECG |
(獨立資料表) | 儲存至 MeasurementEcgRecords
|
| 體脂肪量測 | /api/telecare/InsBodyFat |
BFP |
體脂率 |
| 血氧量測 | /api/telecare/InsS68 |
BO, PR, RR
|
血氧、脈率、呼吸率 (取平均值) |
| 體溫量測 | /api/telecare/InsTemp |
TMP |
體溫 (取陣列第一筆) |
| 總膽固醇 | /api/telecare/InsCholesterol |
TC |
|
| 腰圍量測 | /api/telecare/InsWaist |
WC |
|
| 尿酸量測 | /api/telecare/InsUricAcid |
UA |
|
| 每日步數 | /api/telecare/InsDailyStep |
STP |
由 Sam Wang 於 1 天 前更新
全家寶測試 Host (不包含量測項目位址 "/Insxxx")¶
https://weigong-healthcare-api.dev.viuto-aiot.com/api/telecare/
新增/修改功能 (feature)¶
- [行事曆]開放內容與待辦事項給衛生局(HealthAdm)身分。
修正 (fix)¶
- [全家寶]修正全域授權過濾權限衝突，確保 [AllowAnonymous] 端點能正確進入。
內部改進 (Internal)¶
- [全家寶]重構 API 異常回應代碼，全面採用 Dtos.Common.ErrorCodes 標準值。
- [全家寶]端點日誌紀錄，包含請求內容 (Payload)、身分驗證結果與處理進度。
動作