T-SIOT 313-2021 智慧健康養(yǎng)老 室內(nèi)運動健康監(jiān)測與運動數(shù)據(jù)接口技術要求

35.240.80CCS

L

09登記號：XXXXX T/SIOT

智慧健康養(yǎng)老 室內(nèi)運動健康監(jiān)測與運動數(shù)據(jù)接口技術要求

care

-

Technical

indoor

sports

healthmonitoring

exercise

data

上

海

市

物

聯(lián)

網(wǎng)

行

業(yè)

協(xié)

會 發(fā)

布T/SIOT

313-2021 前言

.................................................................................

II1

...............................................................................

32 規(guī)范性引用文件

.....................................................................

33 術語和定義

.........................................................................

34 縮略語

.............................................................................

45

.............................................................

45.1 系統(tǒng)結構

.......................................................................

45.2 數(shù)據(jù)接口分類

...................................................................

56 數(shù)據(jù)接口的安全性要求

...............................................................

66.1 數(shù)據(jù)接口的數(shù)據(jù)加密要求

.........................................................

66.2 數(shù)據(jù)接口的數(shù)據(jù)完整性要求

.......................................................

67

.............................................................

67.1 通用要求

.......................................................................

67.1.1 統(tǒng)一用戶標識

...............................................................

67.1.2 狀態(tài)碼及錯誤信息

...........................................................

67.1.3 設備類型

...................................................................

77.2 信息同步相關接口

...............................................................

97.2.1 傳入用戶信息

...............................................................

97.3 識別用戶身份相關接口

..........................................................

107.3.1 識別用戶身份

..............................................................

107.3.2 上傳人臉照片

..............................................................

107.3.3

........................................................

117.4 獲取用戶信息相關接口

..........................................................

117.4.1 獲取用戶信息

..............................................................

117.4.2 獲取運動建議

..............................................................

127.5 上傳數(shù)據(jù)相關接口

..............................................................

137.5.1 上傳用戶體測數(shù)據(jù)

..........................................................

137.5.2 上傳運動數(shù)據(jù)

..............................................................

17參考文獻

.............................................................................

19T/SIOT

313-2021 本文件按照GB/T

—《標準化工作導則 第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由上海市物聯(lián)網(wǎng)行業(yè)協(xié)會提出并歸口?；ヂ?lián)網(wǎng)有限公司、電信科學技術第一研究所有限公司、迪愛斯信息技術股份有限公司。本標準主要起草人：王海龍、周微、葉曉華、盧文云、徐敏、徐一涵、袁江楓、姚麗瑩、保志軍、莉琴。海陸道智城文化創(chuàng)意產(chǎn)業(yè)集團股份有限公司、上海長庚家庭服務有限公司。IIT/SIOT

313-2021 1 范圍結構與接口分類、數(shù)據(jù)接口的安全性要求、數(shù)據(jù)接口的消息格式要求等。本文件適用于智慧健康養(yǎng)老領域室內(nèi)運動場館的運營管理系統(tǒng)與智能健康監(jiān)測設備和智能運動器械之間的數(shù)據(jù)通訊接口設計。2 規(guī)范性引用文件文件。GB

17859—1999

計算機信息系統(tǒng)

安全保護等級劃分準則GB/T

20270—2006

信息安全技術

網(wǎng)絡基礎安全技術要求GB/T

20271—2006

信息安全技術

信息系統(tǒng)通用安全技術要求JGJ/T484—2019

養(yǎng)老服務智能化系統(tǒng)技術標準T/CSGF

004—2018

智慧化健身場所技術規(guī)范3 術語和定義下列術語和定義適用于本文件。3.1數(shù)據(jù)接口

data

interface決軟件之間的兼容性問題。3.2場館運營管理系統(tǒng)

venue

operation

management

的進行內(nèi)部管理、及時準確的把握場館的經(jīng)營狀況。3.3智能健康監(jiān)測設備

health

equipment康監(jiān)測設備不具備的功能。3.4智能運動器械

sports

equipment運動數(shù)據(jù)的上傳等傳統(tǒng)運動器械不具備的功能。T/SIOT

313-20214 縮略語下列縮略語適用于本文件。HTTPS

超文本傳輸安全協(xié)議（Hyper

Text

Transfer

Protocol

over

SecureSocket

Layer）JSON

JavaScript

Notation）UUID

通用唯一識別碼（

Unique

）Wi-Fi

無線局域網(wǎng)（Wireless

Fidelity）5 系統(tǒng)結構及數(shù)據(jù)接口分類5.1 系統(tǒng)結構1動提供支持，如建立和查看用戶健康檔案等。智能健康監(jiān)測設備和智能運動器械部署在場館內(nèi)，通過Wi-Fi、以太網(wǎng)的方式接入到互聯(lián)網(wǎng)，與場館運營管理系統(tǒng)通訊，實現(xiàn)身份鑒別、用戶信息下發(fā)、運動據(jù)和運動數(shù)據(jù)。圖1 系統(tǒng)結構圖接口分類接口名稱接口說明T/SIOT

313-20215.2 數(shù)據(jù)接口分類系統(tǒng)中涉及的數(shù)據(jù)接口分類見表1。表1 系統(tǒng)接口分類表接口分類接口名稱接口說明T/SIOT

313-20216 數(shù)據(jù)接口的安全性要求6.1 數(shù)據(jù)接口的數(shù)據(jù)加密要求應對在數(shù)據(jù)接口間傳輸?shù)臄?shù)據(jù)進行保密性保護。6.2 數(shù)據(jù)接口的數(shù)據(jù)完整性要求情況發(fā)生。7 數(shù)據(jù)接口的消息格式要求7.1 通用要求7.1.1 統(tǒng)一用戶標識UUID的生成方法必須遵循由開放軟件基金會(OSF)制定的RFC4122標準，以保證對在同一時空中的所有機器都是唯一的。7.1.2 狀態(tài)碼及錯誤信息用的狀態(tài)碼定義見表2。錯誤代碼分類錯誤代碼說明1-999保留給各接口自定義業(yè)務流程中出現(xiàn)的失敗，如用戶名錯1001

id1002

100310042001

id

2002

token

token

3001300290019999設備大類名稱設備類型名稱設備類型編號0100101002010030100401005T/SIOT

313-2021表2 通用返回狀態(tài)碼表7.1.3 設備類型各接口中有設備類型編號確定上傳數(shù)據(jù)的設備類型，其編號規(guī)則為兩位數(shù)字的設備大類編號+數(shù)字的設備具體類型編號。其中設備大類編號為： 01：功能性有氧； 02：微循環(huán)促進； 03：等速肌力； 04：柔韌拉伸； 05：單功能力量。相同的設備類型編號。各接口中涉及到設備類型的字段，設備類型名稱和設備類型編號的對應關系見表3.表3 設備類型信息表設備大類名稱設備類型名稱設備類型編號0200102002020030200403001030020300303004030050300603007030080400104002040030400404005040060500105002050030500405005050060500705008坐姿后仰腰背訓練器0500905010050110501205013T/SIOT

313-2021設備大類名稱設備類型名稱設備類型編號050140501505016050170501805019050200502105022高拉、低拉雙功能訓練器050230502405025050260502705028參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

iduser_uuidString64nameString32id_card_noString32mobile_numberString16String64參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯時返回，用于輔助解讀錯誤的原因T/SIOT

313-20217.2 信息同步相關接口7.2.1 傳入用戶信息用于在不同的場館運營系統(tǒng)之間，同步用戶的數(shù)據(jù)。要求能夠支持傳入表4所述的數(shù)據(jù)：表4 傳入用戶信息請求消息參數(shù)表要求能夠返回表5所述的數(shù)據(jù)：表5要求能夠返回表5所述的數(shù)據(jù)：參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

idstore_idString64

IDauth_typeInteger32

auth_credentialString641.

2.

如果是人臉識別需要先上傳照片后再上送照3.

’|’參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯時返回，用于輔助解讀錯誤的原因user_uuidString64user_tokenString64

user_token_thrutimeLong64

參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

idT/SIOT

313-20217.3 識別用戶身份相關接口7.3.1 識別用戶身份用于智能健康監(jiān)測設備和智能運動器械，向場館運營系統(tǒng)查詢用戶的身份。要求能夠支持傳入表6所述的數(shù)據(jù)：表6 識別用戶身份請求消息參數(shù)表要求能夠返回表7所述的數(shù)據(jù)。表7要求能夠返回表7所述的數(shù)據(jù)。7.3.2 上傳人臉照片份。要求能夠支持傳入表8所述的數(shù)據(jù)。表8 上傳人臉照片請求消息參數(shù)表10參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096barcode_contentString4096參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯時返回，用于輔助解讀錯誤的原因image_file_nameString64參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明image_file_typeString32image_fileFile8M參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

idString64

id參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

iduser_uuidString64T/SIOT

313-2021要求能夠返回表9所述的數(shù)據(jù)。表9要求能夠返回表9所述的數(shù)據(jù)。7.3.3 獲取用戶登錄二維碼身份。要求能夠支持傳入表10所述的數(shù)據(jù)：表10 獲取用戶登錄二維碼請求消息參數(shù)表要求能夠返回表11所述的數(shù)據(jù)。表11要求能夠返回表11所述的數(shù)據(jù)。7.4 獲取用戶信息相關接口7.4.1 獲取用戶信息表12所述的數(shù)據(jù)。表12 獲取用戶信息請求消息參數(shù)表11參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯時返回，用于輔助解讀錯誤的原因user_inforString4096

JSON

‐

name‐

age‐

gender

‐

weightFloat‐

height‐

‐

‐

risk_level?

?

?

?

‐

taboos

14參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

iduser_uuidString64user_tokenString64

字段名數(shù)據(jù)類型最大長度參數(shù)說明taboo_typeInteger32

taboo_descString512base64

參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明user_tokenString64

T/SIOT

313-2021要求能夠獲取表13所述的數(shù)據(jù)。表13要求能夠獲取表13所述的數(shù)據(jù)。表14 運動禁忌信息參數(shù)表7.4.2 獲取運動建議表15所述的數(shù)據(jù)。表15 獲取運動建議請求消息參數(shù)表要求能夠獲取表16要求能夠獲取表16所述的數(shù)據(jù)。參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯時返回，用于輔助解讀錯誤的原因String4096

JSON

‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

Integer‐

exercise_risk

decode

,String參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

iduser_uuidString64user_tokenString64

user_examine_dataString1M

JSON

18T/SIOT

313-2021表16 獲取運動建議返回消息參數(shù)表7.5 上傳數(shù)據(jù)相關接口7.5.1 上傳用戶體測數(shù)據(jù)17所述的數(shù)據(jù)。表17 上傳用戶體測數(shù)據(jù)請求消息參數(shù)表13字段名稱字段說明數(shù)據(jù)類型是否必填參數(shù)說明check_timeDateTimeyyyy-mm-dd

hh:mi:sscheck_typeInteger

hightFloatweightFloatIntegergrip_strengthFloatinflectFloataction_timeFloatIntegerblood_oxygen_saturationFloatpulse_rateIntegerdiastolic_pressure;Integersystolic_pressureIntegerString

JSON

String

JSON

19參數(shù)名數(shù)據(jù)類型參數(shù)說明weiFloatheiFloatgenIntegerageIntegertbwFloatffmFloatminFloatbmiFloatfatFloatpbfFloatmusFloatvfaFloatwhrFloatproFloatsmmFloatT/SIOT

313-2021表18 體測數(shù)據(jù)格式說明表表19 人體成分數(shù)據(jù)格式說明表14參數(shù)名數(shù)據(jù)類型參數(shù)說明larmmFloatrarmmFloatllegmFloatrlegmFloattrmFloatevalarmmFloatevalfatFloatevallegmFloatevalminFloatevalproFloatscoreFloatshapeIntegertarweiFloatctrweiFloatctrmusFloatctrfatFloatbmrFloatcdayFloatmaxweiFloatminweiFloatstdweiFloatmaxfatFloatminfatFloatstdfatFloatmaxffmFloatminffmFloatstdffmFloatmaxtbwFloatmintbwFloatstdtbwFloatmaxminFloatminminFloat1515T/SIOT

313-2021參數(shù)名數(shù)據(jù)類型參數(shù)說明stdminFloatmaxbmiFloatminbmiFloatstdbmiFloatmaxvfaFloatminvfaFloatstdvfaFloatmaxwhrFloatminwhrFloat腰臀比低值stdwhrFloatmaxproFloatminproFloatstdproFloatmaxarmmFloatminarmmFloatstdarmmFloatmaxlegmFloatminlegmFloatstdlegmFloatmaxtrmFloatmintrmFloatstdtrmFloatmaxpbfFloatminpbfFloatstdpbfFloatmaxsmmFloatminsmmFloatstdsmmFloatra5kFloat

5kHz

la5kFloat

5kHz

tr5kFloat

5kHz

rl5kFloat

5kHz

ll5kFloat

5kHz

ra50kFloat

la50kFloat

tr50kFloat

rl50kFloat

ll50kFloat

ra250kFloat

250kHz

la250kFloat

250kHz

T/SIOT

313-202116參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明terminal_idString64

iddevice_typeInteger32

22user_uuidString64user_tokenString64

String1M

JSON

22有氧類的設備上傳的數(shù)據(jù)格式詳見表

24

25字段名數(shù)據(jù)類型最大長度參數(shù)說明Integer32total_kcalFloat32

kcaltotal_weightFloat32

kgInteger32Integer32groupsString4096

JSON

23參數(shù)名數(shù)據(jù)類型參數(shù)說明tr250kFloat

250kHz

rl250kFloat

250kHz

ll250kFloat

250kHz

參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096字段名數(shù)據(jù)類型最大長度參數(shù)說明duration_sInteger32T/SIOT

313-2021要求能夠返回表20所述的數(shù)據(jù)。表20要求能夠返回表20所述的數(shù)據(jù)。7.5.2 上傳運動數(shù)據(jù)明見表22-表25。表21 上傳運動數(shù)據(jù)請求消