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

35.240.80CCS

L

09登記號(hào)：XXXXX T/SIOT

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

care

-

Technical

indoor

sports

healthmonitoring

exercise

data

上

海

市

物

聯(lián)

網(wǎng)

行

業(yè)

協(xié)

會(huì) 發(fā)

布T/SIOT

313-2021 前言

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

II1

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

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

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

33 術(shù)語和定義

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

34 縮略語

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

45

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

45.1 系統(tǒng)結(jié)構(gòu)

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

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)一用戶標(biāo)識(shí)

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

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

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

67.1.3 設(shè)備類型

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

77.2 信息同步相關(guān)接口

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

97.2.1 傳入用戶信息

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

97.3 識(shí)別用戶身份相關(guān)接口

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

107.3.1 識(shí)別用戶身份

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

107.3.2 上傳人臉照片

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

107.3.3

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

117.4 獲取用戶信息相關(guān)接口

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

117.4.1 獲取用戶信息

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

117.4.2 獲取運(yùn)動(dòng)建議

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

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

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

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

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

137.5.2 上傳運(yùn)動(dòng)數(shù)據(jù)

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

17參考文獻(xiàn)

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

19T/SIOT

313-2021 本文件按照GB/T

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

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

17859—1999

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

安全保護(hù)等級(jí)劃分準(zhǔn)則GB/T

20270—2006

信息安全技術(shù)

網(wǎng)絡(luò)基礎(chǔ)安全技術(shù)要求GB/T

20271—2006

信息安全技術(shù)

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

養(yǎng)老服務(wù)智能化系統(tǒng)技術(shù)標(biāo)準(zhǔn)T/CSGF

004—2018

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

data

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

venue

operation

management

的進(jìn)行內(nèi)部管理、及時(shí)準(zhǔn)確的把握?qǐng)鲳^的經(jīng)營狀況。3.3智能健康監(jiān)測設(shè)備

health

equipment康監(jiān)測設(shè)備不具備的功能。3.4智能運(yùn)動(dòng)器械

sports

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

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

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

Text

Transfer

Protocol

over

SecureSocket

Layer）JSON

JavaScript

Notation）UUID

通用唯一識(shí)別碼（

Unique

）Wi-Fi

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

Fidelity）5 系統(tǒng)結(jié)構(gòu)及數(shù)據(jù)接口分類5.1 系統(tǒng)結(jié)構(gòu)1動(dòng)提供支持，如建立和查看用戶健康檔案等。智能健康監(jiān)測設(shè)備和智能運(yùn)動(dòng)器械部署在場館內(nèi)，通過Wi-Fi、以太網(wǎng)的方式接入到互聯(lián)網(wǎng)，與場館運(yùn)營管理系統(tǒng)通訊，實(shí)現(xiàn)身份鑒別、用戶信息下發(fā)、運(yùn)動(dòng)據(jù)和運(yùn)動(dòng)數(shù)據(jù)。圖1 系統(tǒng)結(jié)構(gòu)圖接口分類接口名稱接口說明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ù)加密要求應(yīng)對(duì)在數(shù)據(jù)接口間傳輸?shù)臄?shù)據(jù)進(jìn)行保密性保護(hù)。6.2 數(shù)據(jù)接口的數(shù)據(jù)完整性要求情況發(fā)生。7 數(shù)據(jù)接口的消息格式要求7.1 通用要求7.1.1 統(tǒng)一用戶標(biāo)識(shí)UUID的生成方法必須遵循由開放軟件基金會(huì)(OSF)制定的RFC4122標(biāo)準(zhǔn)，以保證對(duì)在同一時(shí)空中的所有機(jī)器都是唯一的。7.1.2 狀態(tài)碼及錯(cuò)誤信息用的狀態(tài)碼定義見表2。錯(cuò)誤代碼分類錯(cuò)誤代碼說明1-999保留給各接口自定義業(yè)務(wù)流程中出現(xiàn)的失敗，如用戶名錯(cuò)1001

id1002

100310042001

id

2002

token

token

3001300290019999設(shè)備大類名稱設(shè)備類型名稱設(shè)備類型編號(hào)0100101002010030100401005T/SIOT

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

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

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

resp_msgString4096返回消息，出錯(cuò)時(shí)返回，用于輔助解讀錯(cuò)誤的原因T/SIOT

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

idstore_idString64

IDauth_typeInteger32

auth_credentialString641.

2.

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

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

resp_msgString4096返回消息，出錯(cuò)時(shí)返回，用于輔助解讀錯(cuò)誤的原因user_uuidString64user_tokenString64

user_token_thrutimeLong64

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

idT/SIOT

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

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

resp_msgString4096返回消息，出錯(cuò)時(shí)返回，用于輔助解讀錯(cuò)誤的原因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 獲取用戶登錄二維碼請(qǐng)求消息參數(shù)表要求能夠返回表11所述的數(shù)據(jù)。表11要求能夠返回表11所述的數(shù)據(jù)。7.4 獲取用戶信息相關(guān)接口7.4.1 獲取用戶信息表12所述的數(shù)據(jù)。表12 獲取用戶信息請(qǐng)求消息參數(shù)表11參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯(cuò)時(shí)返回，用于輔助解讀錯(cuò)誤的原因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 運(yùn)動(dòng)禁忌信息參數(shù)表7.4.2 獲取運(yùn)動(dòng)建議表15所述的數(shù)據(jù)。表15 獲取運(yùn)動(dòng)建議請(qǐng)求消息參數(shù)表要求能夠獲取表16要求能夠獲取表16所述的數(shù)據(jù)。參數(shù)名數(shù)據(jù)類型最大長度參數(shù)說明resp_codeInteger32

resp_msgString4096返回消息，出錯(cuò)時(shí)返回，用于輔助解讀錯(cuò)誤的原因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 獲取運(yùn)動(dòng)建議返回消息參數(shù)表7.5 上傳數(shù)據(jù)相關(guān)接口7.5.1 上傳用戶體測數(shù)據(jù)17所述的數(shù)據(jù)。表17 上傳用戶體測數(shù)據(jù)請(qǐng)求消息參數(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 人體成分?jǐn)?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è)備上傳的數(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 上傳運(yùn)動(dòng)數(shù)據(jù)明見表22-表25。表21 上傳運(yùn)動(dòng)數(shù)據(jù)請(qǐng)求消