DB35T 2188-2024 海峽兩岸共通 智能鞋服數據接口要求

ICS01.12035CCSA0035福 建 省 地 方 標 準DB35/T2188—2024海峽兩岸共通 智能鞋服數據接口要求Cross-straitintegrateddevelopment—Datainterfacerequirementsofsmartshoesandclothing2024-07-03發(fā)布 2024-10-03實施福建省市場監(jiān)督管理局 發(fā)布DB35/T2188—2024目 次前言 II引言 III范圍 1規(guī)范性引用文件 1術語和定義 1縮略語 1接口框架 1通用要求 2技術要求 3接口設計 4附錄A（資料性） 智能鞋服數據接口參數JSON代碼示例 8IDB35/T2188—2024前 言本文件按照GB/T1.1—2020《標準化工作導則 第1部分：標準化文件的結構和起草規(guī)則》的規(guī)起草。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由福建奇鷺物聯網科技股份公司提出。本文件由福建省信息化標準化技術委員會(SAFJ/TC11)歸口。（福建（中國臺灣技有限公司。本文件主要起草人：林儀清、莊榕榕、王成、范宗文、緱錦、張惠臻、蕭宗志（中國臺灣）、林瑤（中國臺灣）、方龍祥（中國臺灣）、吳楚東。IIDB35/T2188—2024引 言2025推廣有著重要意義。智能鞋服數據接口要求的制定有助于推動智能鞋服在數據接口方面的進步及示范推廣，促進行業(yè)管理水平的進一步提升。IIIDB35/T2188—2024海峽兩岸共通 智能鞋服數據接口要求范圍本文件規(guī)定了海峽兩岸智能鞋服數據的接口框架、通用要求、技術要求和接口設計。本文件適用于海峽兩岸鞋服行業(yè)智能鞋服的數據采集、傳輸、管理和應用及相關接口設計。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T7408.1—2023 日期和時間 信息交換表示法 第1部分：基本原則術語和定義下列術語和定義適用于本文件。智能鞋服 smartshoesandclothing能力的穿戴鞋服。注：通常具有多種感知、狀態(tài)或生理指標監(jiān)測等功能?？s略語下列縮略語適用于本文件。APP：應用程序（Application）HTTPS：安全超文本傳輸協(xié)議（HypertextTransferProtocolSecure）ID：唯一標識號（Identification）JSON：JavaScript對象表示法（JavaScriptObjectNotation）JWT：JSON網頁令牌（JSONWebToken）OPP：對象存儲規(guī)范（ObjectPushProfile）XML：可擴展標記語言（eXtensibleMarkupLanguage）接口框架智能鞋服的數據接口框架見圖1，包含智能鞋服終端、智能鞋服應用、服務端（數據管理、數據處理與計算），以及數據采集接口、狀態(tài)監(jiān)測接口、身份驗證接口、數據應用接口。1DB35/T2188—2024數據應用接口數據應用接口狀態(tài)監(jiān)測接口身份驗證接口用戶端數據采集接口智能鞋服應用端服務端智能鞋服終端數據管理模塊圖1 智能鞋服數據接口框架智能鞋服終端采集使用者的相關數據；智能鞋服應用端為用戶提供查看位置運動和健康狀態(tài)可視等反饋和建議；控制管理接口能設置智能鞋服開關機狀態(tài)、檢測間隔等。數據采集接口用于將智能鞋服終端的各類數據傳輸到智能鞋服應用端，可實時獲取智能鞋服使用者的相關數據。狀態(tài)監(jiān)測接口用于收集、傳輸智能鞋服相關狀態(tài)監(jiān)測數據。身份驗證接口用于驗證用戶的身份信息，保障合法用戶用智能鞋服的功能。數據應用接口用于將服務端的數據分析挖掘結果和智能鞋服的控制信息傳輸到應用端。通用要求智能鞋服數據接口應滿足以下要求：JSON、XMLWebHTTPSOPPJWT鑒權驗證；POST接口提供錯誤處理機制，包括錯誤代碼和錯誤信息。當出現錯誤時，返回相應的錯誤提示；數據交換接口具備互操作性；接口具備可擴展性；1。2DB35/T2188—2024表1 數據類型及格式說明表序號數據類型數據格式說明1字符型以大寫字母“C”代表字符型：CX：表示定長為“X”的字符型數據元值；C..X：表示最長為“X”C..ul：表示長度不確定的字符型數據元值一切能顯示打印的字具有計算能力2數值型以大寫字母“NUM”代表數值型：NUM..（X：表示最長為“X”的數值型數據元值；NUM..（X,y：表示總長度為“X”位、其中小數點后為位的數值型數據元值進行數學運算的數據3日期時間型YYYYMMDD：表示YYYY年MM月DD日的日期格式；YYYYMMDDHHmmss：表示YYYY年MM月DD日mm分ss秒的時間格式采用GB/T7408.1—2023的規(guī)定用以表示日期及時間的數據技術要求數據采集接口數據采集接口應滿足以下要求：求添加其他字段；更新；其他靜態(tài)信息宜定期更新。狀態(tài)監(jiān)測接口含通訊/傳輸狀態(tài)監(jiān)測、報錯頻率/狀態(tài)監(jiān)測。狀態(tài)監(jiān)測接口滿足以下要求：心率監(jiān)測：監(jiān)測用戶的心率數據，包括心率變化、心率異常等；步數監(jiān)測：監(jiān)測用戶的步行數據，包括步數、睡眠-活動關聯等；睡眠監(jiān)測：監(jiān)測用戶的睡眠質量，包括睡眠時間、深睡時間、淺睡時間等；溫度監(jiān)測：監(jiān)測智能鞋服穿戴溫度數據；濕度監(jiān)測：監(jiān)測智能鞋服穿戴濕度數據；位置監(jiān)測：監(jiān)測用戶的位置及行走路線；通訊/傳輸狀態(tài)監(jiān)測：監(jiān)測數據包的大小、速率；報錯頻率/狀態(tài)監(jiān)測：監(jiān)測報錯頻率/狀態(tài)。身份驗證接口身份驗證接口的內容包括但不限于：SM2牌，以取得相應的接口數據請求權限；驗證結果接口：身份驗證結果返回。3DB35/T2188—2024數據應用接口數據應用接口的內容包括但不限于：數據處理與分析的接口包括用戶位置監(jiān)測、健康狀態(tài)監(jiān)測、智能鞋服使用區(qū)域等分析應用；間隔等。接口設計數據采集接口通過硬件設備采集信息。接口地址：https://IP地址:端口/接口類型：websocket。接口名稱：DataCollection輸入/請求參數：見表2。/返回參數：見表3。請求示例：見附錄A的A.1.1。返回示例：見附錄A的A.1.2。表2 數據采集接口輸入參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2設備類型deviceTypeC1是1：鞋；2：服飾；3：其它3采集開始時間beginTimeYYYYMMDDHHmmss是—4采集結束時間endTimeYYYYMMDDHHmmss是—表3 數據采集接口輸出參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2時間timeYYYYMMDDHHmmss是當前時間3經緯度longitudeAndLatitudeC..50是當前位置的經緯度信息4響應碼codeC1是1：成功；0：失敗5提示信息messageC..200否—6溫度temperatureNUM..（3,1）是—7濕度humidityNUM..（3,1）是—8心率heartRateNUM..（3）否單位為次/分（BPM）9步數stepsNUM..（5）否—10睡眠sleepNUM..（2）否睡眠時長，單位為小時（h）4DB35/T2188—2024狀態(tài)監(jiān)測接口通過應用端監(jiān)測智能鞋服穿戴者的心率、步數、溫度、濕度、位置等信息。接口地址：https://IP地址:端口/。接口類型：websocket。接口名稱：DeviceStateReport輸入/請求參數：見表4。/返回參數：見表5。請求示例：見附錄A的A.2.1。返回示例：見附錄A的A.2.2。表4 狀態(tài)監(jiān)測接口輸入參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDIdC32是—2設備類型deviceTypeC1是1：鞋；2：服飾；3：其它表5 狀態(tài)監(jiān)測接口輸出參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2心率heartRateNUM..（3）否單位為次/分（BPM）3步數stepsNUM..（5）否—4睡眠sleepNUM..（5）否單位為秒（S）5溫度temperatureNUM..（3,1）是—6濕度humidityNUM..（3,1）是—7經緯度longitudeAndLatitudeC..50是當前位置的經緯度信息8數據包大小packetSizeNUM..（5）是單位為字節(jié)（B）9數據包速率packetRateNUM..（3,2）是單位為兆比特每秒（Mbps）10報錯頻率errorRateNUM..（3）是單位為次/秒11響應碼codeC1是1：成功；0：失敗12提示信息messageC..200否—13電量electricityNUM..（3）是—14版本versionNUM..（4）是—身份驗證接口通過應用端驗證用戶訪問權限。接口地址：https://IP地址:端口/接口類型：websocket。接口名稱：AuthLogin。輸入/請求參數：見表6/返回參數：見表7請求示例：見附錄A的A.3.1。5DB35/T2188—2024返回示例：見附錄A的A.3.2。表6 身份驗證接口輸入參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2應用程序密鑰appKeyC..13是—3隨機字符串參數nonceC..32是—4時間timeYYYYMMDDHHmmss是當前時間5簽名signC32是校驗簽名表7 身份驗證接口輸出參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2響應碼codeC1是1：成功；0：失敗3提示信息messageC..200否—4訪問令牌accessTokenC..50是使用accessToken進行鑒權數據應用接口接口地址：https://IP地址:端口/接口類型：websocket。接口名稱：DataApplication輸入/請求參數：見表8。/返回參數：見表9。請求示例：見附錄A的A.4.1。返回示例：見附錄A的A.4.2。表8 數據應用接口輸入參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2設備類型deviceTypeC1是1：鞋；2：服飾3：其它6DB35/T2188—2024表9 數據應用接口輸出參數表序號參數名稱英文名稱數據類型及格式是否必填說明1設備IDidC32是—2經緯度longitudeAndLatitudeC..50是當前位置的經緯度信息3健康狀態(tài)healthStatusC1是1：心率太快；2：心率太慢；3：溫度過高；4：溫度過低；5：濕度過高；6：濕度過低4所在區(qū)域regionC..32是—5開關機狀態(tài)onOffStateC1是1：開機狀態(tài)；2：關機狀態(tài)6溫度檢測間隔temperatureIntervalNUM..（3）是單位為分鐘（min）7濕度檢測間隔humidityIntervalNUM..（3）是單位為分鐘（min）8心率檢測間隔heartRateIntervalNUM..（3）是單位為分鐘（min）9響應碼codeC1是1：成功；0：失敗10提示信息messageC..200否—7DB35/T2188—2024附 錄 A（資料性）智能鞋服數據接口參數JSON代碼示例請求示例{"id":"12321431232324353233133353233133","deviceType":"1","beginTime":"2023-08-1114:00:00","endTime":"2023-08-1115:00:00"}響應示例{"id":"35323313312321431232324353233133","locations":[{"time":"2023-08-1114:02:23","longitudeAndLatitude":"113.58762,37.86236"},{"time":"2023-08-1114:05:23","longitudeAndLatitude":"113.58762,37.86221"}],"code":"1","message":"數據采集正常","temperature":"40.4","humidity":"20.5","heartRate":"70","steps":"1000","sleep":"8"}請求示例{"id":"35323313312321431232324353233123","deviceType":"1"}8DB35/T2188—2024響應示例{"id":"12323532331331431232324353233123","heartRate":"70","steps":"1000","sleep":"28800","temperature":"40.4","humidity":"20.5","longitudeAndLatitude":"113.58762,37.86236","packetSize":"1518","packetRate":"10.00","errorRate":"2","code