...
為整合不同廠商智慧醫材之感測資訊,OmniCare 歸納生理資訊資料綱要如下圖所示,共同類別為 OmniCare_Core,其包含裝置序號(deviceId)、起始時間(time)、結束時間(endTime) 等屬性,各生理資訊子類別繼承核心類別再依其特性擴充其特有屬性欄位。
OmniCare平台數據定義 (Schema)
共通參數
deviceId / 裝置名稱 : String time / 起始時間 : String endTime / 結束時間 : String _time / timestamp : Long |
生理參數
數值 | 資料描述 |
體溫 | type/體溫類型[0,1]: String |
血糖 | sourceType/量測方式[0,1]: String |
睡眠 | sourceType/量測方式[0,1]: String |
血壓 | sourceType/量測方式[0,1]: String |
血氧 | sourceType/量測方式[0,1]: String |
活動 | type/活動類型[1]: String |
心電圖 | slotId/採樣資料的序號[1]: Integer |
光電容積圖 | slotId/採樣資料的序號[1]: Integer |
心率變異 | sourceType[0,1]/量測方式: HRVTypeCode |
G Sensor | value/屬性值[1]: Numeric |
Location | alt / Altitude : Double |
環境參數
空氣品質 | AQI/空氣品質指標[0,1]: Integer |
環境條件 | temp_C [0,1]: Double |
大氣壓力 | value/屬性值[1]: Numeric |
高度 | value/屬性值[1]: Numeric |
API
使用流程
透過 getToken API 取得帳戶認證 token 及 sguri 參數
...
使用 OmniCare 服務前,開發者須先以 WebstorageID 進行認證,取得 OmniCare所配發之 Token 及該 WebstorageID 所屬之 ServiceArea,作為其他 API 服務呼叫之標頭資訊。
Request
POST / HTTP/1.1 https://{omnicaredomain}:{port}/auth/user { "pwd":"test@test" } | ||
Name | Description | Required |
uid | ASUS Webstorage Account | Yes |
pwd | ASUS Webstorage Account Password | Yes |
Response
HTTP/1.1 200 { "token":"6uad0caas2cy55", "sguri":"sgd01.asuswebstorage.com", "status":"0" } | ||
Name | Description | Return |
token | OmniCare API 服務之授權Token | Yes |
sguri | Webstorage ID隸屬之服務網址 | Yes |
status | 服務查詢結果狀態(0,1,2) | Yes |
msg | 服務查詢結果狀態描述 | Optional |
GET /api/data/device/:deviceId/:startTime/:endTime
服務功能:供輸入裝置識別碼,取得裝置所感測之生理訊號資料之服務
URL參數說明
Field | Type | Description | Example |
deviceId | String | 所欲查詢資料之儀器裝置序號 | ASUSLife-00002-002 |
startTime | String | 所欲查詢時間之起始時間,以UTC+0 為基準 | 20170531000000 (2017-05-31 00:00:00) |
endTime | String | 所欲查詢時間之結束時間,以UTC+0為基準 | 20170730000000 (2017-07-30 00:00:00) |
Request
GET/ HTTP/1.1 https://{omnicaredomain}:{port}/api/data/device/ASUSLife-00002-002/20170531000000/20170730000000 Authorization:6uad0caas2cy55 sguri: sgd01.asuswebstorage.com {} | ||
Name | Description | Required |
Authorization, sguri is required |
Response
HTTP/1.1 200 { "status":"success", "data":{"omnicare_bloodPressure": [ { "mean": 84, "hr": 98, "time": "2017-07-26 09:51:16", "endTime": "2017-07-26 09:51:16", "sys": 62, "deviceId": "ASUSLife-00002-002", "dia": 87 }, { "mean": 79, "hr": 108, "time": "2017-07-26 09:51:25", "endTime": "2017-07-26 09:51:25", "sys": 77, "deviceId": "ASUSLife-00002-002", "dia": 92 },.... ], "omnicare_activity":[ {....}, {...}, ….] } } | ||
Name | Description | Return |
status | 服務查詢結果狀態(success, fail) | Yes |
data | 所查詢到符合搜尋條件之生理資訊資料 | Yes |
GET /api/data/schema/:schema/:startTime/:endTime
服務功能:以生理資訊之名稱作為查詢條件,取得裝置所感測之生理訊號資料之服務
URL參數說明
Field | Type | Description | Example |
schema | String | 所欲查詢資料之生理訊號類型 | omnicare_bloodPressure |
startTime | String | 所欲查詢時間之起始時間,以UTC+0 為基準 | 20170531000000 (2017-05-31 00:00:00) |
endTime | String | 所欲查詢時間之結束時間,以UTC+0為基準 | 20170730000000 (2017-07-30 00:00:00) |
Request
GET/ HTTP/1.1 https://{omnicaredomain}:{port}/api/data/device/omnicare_bloodPressure/20170531000000/20170730000000 Authorization:6uad0caas2cy55 sguri: sgd01.asuswebstorage.com | ||
Name | Description | Required |
Authorization, sguri is required |
Response
HTTP/1.1 200 { "status":"success", "data":[ { "mean": 84, "hr": 119, "time": "2017-07-21 17:18:40", "endTime": "2017-07-21 17:18:40", "sys": 79, "deviceId": "ASUSLife-00002-001", "dia": 97 }, { "mean": 72, "hr": 99, "time": "2017-07-21 17:18:49", "endTime": "2017-07-21 17:18:49", "sys": 74, "deviceId": "ASUSLife-00002-001", "dia": 71 }, …... ] } | ||
Name | Description | Return |
status | 服務查詢結果狀態(success, fail) | Yes |
data | 所查詢到符合搜尋條件之生理資訊資料 | Yes |
GET /api/devices
服務功能:取得所租用裝置識別碼清單之服務
Request
GET/ HTTP/1.1 https://{omnicaredomain}:{port}/api/devices Authorization:6uad0caas2cy55 sguri: sgd01.asuswebstorage.com | ||
Name | Description | Required |
Authorization, sguri is required |
Response
HTTP/1.1 200 { "status":"success", "data":[ { "DeviceId": "ASUSLife-00002-001" "startTime": "2017-05-23 00:00:00" "endTime": "2017-07-23 00:00:00" }, { "DeviceId": "ASUSLife-00002-002" "startTime": "2017-05-23 00:00:00" "endTime": "2017-07-23 00:00:00" } ……. ] } | ||
Name | Description | Return |
status | 服務查詢結果狀態(success, fail) | Yes |
data | 所查詢到符合搜尋條件之生理資訊資料 | Yes |