動作
功能 #11538
進行中
由 Judy Fan 於 15 天 前加入. 於 1 天 前更新.
概述
0.查詢畫面
0-1. 「請選擇會員類別」移除
-
既有的「心率」、「血氧」、「步數」、「睡眠」、「運動」、「飲食」隱藏
-
新增生理量測項目「血氧/呼吸/心率」、「心電圖」
-
查詢結果欄位
3-1. 「血壓」、「血糖」、「體溫」、「血氧/呼吸/心率」、「心電圖」的管理按鈕, 全家寶打上來的資訊僅呈現[詳情]、[總表], 若是手動新增的資訊就照既有邏輯顯示按鈕
※因為全家寶廠商會執行編輯跟刪除API, 所以暫時不讓同時編輯
3-2. 「上傳方式」改為「資料來源」- 全家寶提供的資料如果 Station 是 null 就換 SiteName, 如果還是 null, 再換UnitName
- 手動新增:機構輸入、民眾輸入→手動輸入
-
「血壓」點[編輯]/[詳情]
4-1.調整欄位：
資料來源
4-2. 新增欄位：
心房顫動：1:有/0:無/NULL:--
-
「血糖」點[編輯]/[詳情]
5-1. 欄位調整：
身體狀況→隱藏此欄位
「狀態」改為→血糖類別
資料來源 -
「體溫」點[編輯]/[詳情]
6-1.調整欄位：
資料來源
6-1. 新增欄位：
量測類型：0:額溫,1：耳溫,2:一般連續體溫,3:基礎體溫,4:腋溫,5:口溫,6:肛溫, 7:手動輸入
服務站名稱：Station(設備上來顯示)/手動:--
7.「血氧/呼吸/心率」點[編輯]/[詳情]
7-1. 既有欄位：
身份證字號
量測時間
量測項目
資料來源
7-2. 新增欄位：
血氧飽和度平均值 (%)
呼吸率平均值 (次/分)
心率平均值 (次/分)
- 「心電圖」點[編輯]/[詳情]
8-1. 既有欄位：
身份證字號
量測時間
量測項目
資料來源
8-2. 新增欄位：
心電圖每秒採樣數
單位
HeartRate 每分鐘心跳數率(單位bpm)
QRS duration(單位 ms)
ST level(單位 mm)
PR interval(單位 ms)
QT interval(單位 ms)
QTc interval(單位 ms)
嚴重程度：A：正常 B：異常C：無法判讀
圖片
8-3. 新增欄位-心電量測結果：1-9：靜態量測;10-12：動態量測
檔案
| 全家寶WebApi傳輸格式定義_V1.8F.pdf (1.79 MB) 全家寶WebApi傳輸格式定義_V1.8F.pdf | Judy Fan, 2026/03/13 上午10:27 | ||
| 心電圖_全家寶.jpg (95.2 KB) 心電圖_全家寶.jpg | Judy Fan, 2026/03/16 上午07:37 | ||
| messageImage_1773905298948.jpg (74.9 KB) messageImage_1773905298948.jpg | Judy Fan, 2026/03/19 上午09:08 | ||
| ex_POST_ESG.md (155 KB) ex_POST_ESG.md | Sam Wang, 2026/03/20 上午09:25 |
由 Laura Huang 於 12 天 前更新
由 Judy Fan 於 9 天 前更新
- 檔案 messageImage_1773905298948.jpg messageImage_1773905298948.jpg 已新增
- 概述 已更新 (差異)
20260319 客戶Line說明表示
「血氧/呼吸/心率」，僅要顯示如圖項目即可
圖片為全家寶畫面
由 Sam Wang 於 8 天 前更新
生理量測與 ECG 紀錄功能相關API¶
量測記錄(GET /api/measurement-record/list)¶
{
"currentPage": 1,
"pageSize": 10,
"totalItems": 8,
"totalPages": 1,
"items": [
{
"identityNumber": "L18****883",
"memberName": "系統管理員",
"age": "126",
"sex": "男",
"location": "竹南鎮正南社區發展協會健康小站",
"hospital": "為恭紀念醫院",
"uploadType": "遠距測量",
"supplierInfoName": "Chilinemd",
"measurementDateStr": "2026/03/19",
"measurementDate": "2026-03-19T12:02:46.908+08:00",
"measurementItemName": "心電圖",
"measurementResult": 74,
"time": null,
"measurementResultMsg": "靜態量測",
"severityLevel": "正常",
"hr": 74.00,
"qrs": 92.00,
"st": -200.00,
"pr": 168.00,
"qt": 324.00,
"qTc": 359.00
},
...
生理量測 (GET /api/v2/health-measure-info/typelist)¶
{
"currentPage": 1,
"pageSize": 10,
"totalItems": 6,
"totalPages": 1,
"items": [
{
"memberName": "體系會員",
"locationName": "竹南鎮正南社區發展協會健康小站",
"hospitalName": "為恭紀念醫院",
"name": "系統管理員",
"identityNumber": "L186657883",
"age": "",
"sex": "",
"identityTypes": "",
"source": "Telecare",
"supplierName": "",
"measurementDate": "2026-03-19T12:02:46.908+08:00",
"itemName": "21",
"value": "74",
"locationCode": "ML00003",
"ids": [
1
],
"userId": 1,
"measurementType": "Ecg",
"recordId": 1,
"inputDataType": "DistantMeasurement",
"inputDataTypeName": "遠距測量"
},
...
單筆紀錄(ECG)¶
GET /api/measurement-management/record?RecordId=1&MeasurementType=Ecg
{
"date": "2026-03-19T12:02:46.908+08:00",
"userId": 1,
"identityNumber": "L186657883",
"type": "Ecg",
"source": "Telecare",
"items": [
{
"recordId": 1,
"itemId": 21,
"code": "ECG",
"name": "心電圖",
"value": 74,
"notes": "ecg/202603/ecg_1_9e4a7c18431a4239ab7dd05155424c2f.jpg",
"time": null,
"hr": 74.00,
"qrs": 92.00,
"st": -200.00,
"pr": 168.00,
"qt": 324.00,
"qTc": 359.00,
"severityLevel": "正常",
"measurementResultMsg": "靜態量測"
}
],
"measurementType": "Ecg"
}
取ECG圖檔¶
GET /api/telecare/ecg-image?relativePath=ecg/202603/ecg_1_9e4a7c18431a4239ab7dd05155424c2f.jpg
由 Sam Wang 於 8 天 前更新
- 檔案 ex_POST_ESG.md ex_POST_ESG.md 已新增
新增/修改 ECG量測記錄¶
同UserID 與量測時間相同，則進行更新，不會新增。
POST /api/measurement-management/v2/ecg
| Request |
|---|
{
"measurementDateTime": "2024-03-20T17:21:00.000+08:00",
"userId": 1,
"terminalType": 2,
"isBluetooth": false,
"hr": 64.0,
"qrs": 90.0,
"st": -201.0,
"pr": 169.0,
"qt": 325.0,
"qTc": 359.0,
"severityLevel": "正常",
"measurementResultMsg": "靜態量測"
}
含圖檔範例如附件(詳細說明參考swagger)
由 Sam Wang 於 6 天 前更新
血氧、呼吸及心率量測記錄 (v0.26.3.22)¶
量測記錄(GET /api/measurement-record/list)¶
MeasurementType: SpO2
{
"currentPage": 1,
"pageSize": 10,
"totalItems": 11,
"totalPages": 2,
"items": [
{
"identityNumber": "L18****883",
"memberName": "系統管理員",
"age": "126",
"sex": "男",
"location": "竹南鎮正南社區發展協會健康小站",
"hospital": "為恭紀念醫院",
"uploadType": "Web 自行輸入",
"supplierInfoName": "",
"measurementDateStr": "2026/03/21",
"measurementDate": "2026-03-21T18:00:00.000+08:00",
"measurementItemName": "血氧/呼吸/心率",
"measurementResult": 97,
"time": null,
"averSaO2": 97,
"averRespirationRate": 15,
"averHeartRate": 74
},
{
"identityNumber": "L18****883",
"memberName": "系統管理員",
"age": "126",
"sex": "男",
"location": "竹南鎮正南社區發展協會健康小站",
"hospital": "為恭紀念醫院",
"uploadType": "遠距測量",
"supplierInfoName": "Chilinemd",
"measurementDateStr": "2026/03/20",
"measurementDate": "2026-03-20T10:09:18.000+08:00",
"measurementItemName": "血氧/呼吸/心率",
"measurementResult": 97,
"time": null,
"averSaO2": 97,
"averRespirationRate": 10,
"averHeartRate": 59
},
...
}
生理量測 (GET /api/v2/health-measure-info/typelist)¶
| 屬性 | 說明 |
|---|---|
| "averSaO2" | 血氧飽和度平均值（%） |
| "averRespirationRate" | 呼吸率平均值（次/分） |
| "averHeartRate" | 心率平均值（bpm） |
{
"currentPage": 1,
"pageSize": 10,
"totalItems": 6,
"totalPages": 1,
"items": [
{
"memberName": "體系會員",
"locationName": "竹南鎮正南社區發展協會健康小站",
"hospitalName": "為恭紀念醫院",
"name": "系統管理員",
"identityNumber": "L186657883",
"age": "",
"sex": "",
"identityTypes": "",
"source": "Manual",
"supplierName": "",
"measurementDate": "2026-03-21T22:00:00.000+08:00",
"itemName": "-17",
"value": "97",
"locationCode": "ML00003",
"averSaO2": 97,
"averRespirationRate": 15,
"averHeartRate": 74,
"ids": [
5
],
"userId": 1,
"measurementType": "SpO2",
"recordId": 5,
"inputDataType": "WebSelf",
"inputDataTypeName": "Web 自行輸入"
},
...
}
單筆紀錄(SpO2)¶
提供完整 血氧/呼吸/心率 全面資訊(若是來自設備上傳)，手動方式只會有平均。
GET /api/measurement-management/record?RecordId=1&MeasurementType=SpO2
{
"date": "2026-03-20T10:09:18.000+08:00",
"userId": 1,
"identityNumber": "L186657883",
"type": "Spo2",
"source": "Telecare",
"items": [
{
"recordId": 1,
"itemId": -17,
"code": "SPO2",
"name": "血氧/呼吸/心率",
"value": 97,
"notes": "",
"time": null,
"averSaO2": 97,
"maxSaO2": 98,
"minSaO2": 97,
"averRespirationRate": 10,
"maxRespirationRate": 12,
"minRespirationRate": 7,
"averHeartRate": 59,
"maxHeartRate": 65,
"minHeartRate": 57,
"odi4TotalCount": 0,
"odi4CountPerHour": 0,
"odi3TotalCount": 0,
"odi3CountPerHour": 0
}
],
"measurementType": "Spo2"
}
手動新增/修改 血氧、呼吸及心率量測¶
同UserID 與量測時間相同，則進行更新，不會新增。
POST /api/measurement-management/v2/Spo2
{
"measurementDateTime": "2026-03-21T22:00:00.000+08:00", // 量測時間
"userId": 1, // 量測對象的 UserId (選填，不傳則為自己)
"terminalType": "Web", // 終端類型 (可選: Web, App, Supplier)
"isBluetooth": false, // 是否為藍芽
// --- 血氧飽和度 (必要: AverSaO2) ---
"averSaO2": 97.0,
"maxSaO2": 98.0, // 選填
"minSaO2": 95.0, // 選填
// --- 呼吸率 (必要: AverRespirationRate) ---
"averRespirationRate": 15.0,
"maxRespirationRate": 19.0, // 選填
"minRespirationRate": 11.0, // 選填
// --- 心率 (必要: AverHeartRate) ---
"averHeartRate": 74.0,
"maxHeartRate": 84.0, // 選填
"minHeartRate": 64.0 // 選填
}
由 Sam Wang 於 1 天 前更新
異動端點KE中文改為英文 GET /api/measurement-management/list
基礎欄位 (Hardcoded)¶
| 目前中文 Key | 建議英文 Key | 說明 |
|---|---|---|
| 資料 ID | recordId |
紀錄唯一識別碼 |
| 量測日期 | measurementDate |
量測時間戳 |
| 來源 | source |
資料來源（如 Device, Manual） |
| 備註 | note |
備註事項 |
量測項目 (Dynamic)¶
以下為系統現有所有量測項目對照清單：
| 類別 | 中文名稱 | 建議 Key (Code) | 單位 |
|---|---|---|---|
| 血壓 (BP) | 收縮壓 | SBP |
mmHg |
| 舒張壓 | DBP |
mmHg | |
| 脈搏 | P |
bpm | |
| 微量白蛋白 | UACR |
mg/dL | |
| 血糖 (BG) | 空腹血糖 | AC |
mg/dL |
| 飯後血糖 | PC |
mg/dL | |
| 隨機血糖 | NM |
mg/dL | |
| 醣化血色素 | HbA1c |
% | |
| 身體狀況 | BODY |
- | |
| 血氧 (BO) | 血氧 | BO |
% |
| 血脂 (BL) | 總膽固醇 | TC |
mg/dL |
| 三酸甘油酯 | TG |
mg/dL | |
| 高密度脂蛋白 | HDL |
mg/dL | |
| 低密度脂蛋白 | LDL |
mg/dL | |
| 基礎健康 (BH) | 身高 | Ht |
cm |
| 體重 | Wt |
kg | |
| 體脂肪 | BFP |
% | |
| 身體質量指數 | BMI |
kg/m² | |
| 內臟脂肪等級 | VFL |
- | |
| 腰圍 | WC |
- | |
| 心電圖 | ECG |
- | |
| 一般健康 (HLTH) | 步數 | STP |
步 |
| 睡眠 | SLP |
小時 | |
| 睡眠自評 | GRADE |
- | |
| 睡眠開始時間 | SLPS |
- | |
| 睡眠結束時間 | SLPE |
- | |
| 體溫 | TMP |
°C | |
| 心律 | HR |
bpm | |
| 飲食 | FOD |
- | |
| 運動 | EXR |
- | |
| 預防保健 (PH/VC) | 眼底檢查 | OPH |
- |
| 成人預防保健 | APC |
- | |
| 大腸癌篩檢 | CRC |
- | |
| 子宮頸抹片 | PAP |
- | |
| 乳房攝影 | MAM |
- | |
| 口腔黏膜檢查 | ORAL |
- | |
| 兒童預防保健 | CHC |
- | |
| 流感疫苗 | FLU |
- |
修正後的範例 (僅 Key 改英文，Value 維持原樣)¶
{
"recordsNew": [
{
"recordId": 12345,
"measurementDate": "2026-03-26T10:00:00.0000000Z",
"source": "App 藍牙輸入",
"sbp": 120,
"dbp": 80,
"p": 72,
"note": "量測正常"
}
]
}
動作