新現代五項運動會 數據串接API 格式說明

tags: 新現代五項,API

Introduction

環境 URL
測試站 itsport.tw/stage/sporetrofit/api/
正式站 itsport.tw/sporetrofit/api/

HTTP Request:

POST URL/設備類別碼

ex1: https://itsport.tw/stage/sporetrofit/api/OrinArch/
ex2: https://itsport.tw/stage/sporetrofit/api/STAMPEDE/

Request Body :

參數名稱 格式 長度 必要 描述
Data.service 服務名稱 50 N 默認為ITSportData
Data.DateTime TimeStamp 10 Y 開始時間
Data.EndTime TimeStamp 10 Y 結束時間
Data.Mac String 20 Y 設備唯一碼，可使用網卡位置
Data.Type String 20 Y 設備類別碼
OrinArch
STAMPEDE
uGYMRowing
SmartBoard
VAR_BOX
Uniigym
NAPA
Data.Summary String 20 Y 數據簡易呈現內容
Data.Version String 20 Ｎ 未輸入則以０判定，不同的資料版本使用不同的UI呈現

JSON格式 其他欄位可以自行夾帶 顯示端需要之資料內容

Reponse Body:

name description memo
Data.ServiceName 服務名稱 ITSportData
Data.Status 1(呼叫成功)/0(呼叫失敗)
Data.Result.ReulstMsg 回傳訊息
Data.Result.ReulstCode 回傳代碼
Data.Result.Data 回傳資料 N/A

Example:

request 1

{
  "Data":{
    "DATETIME": "1648474644",
    "ENDTIME": "1648475335",
    "MAC": "30AEA4982644",
    "Type": "Treadmill",
    "Distance":[0,0.06,0.06,0.46,0.47,0.48,0.73,0.75,0.75,0.75,0.76,1.35,1.35,-0.01],
    "Speed":[1.48,7.99,7.99,5.95,5.6,5.6,4.47,4.47,3.92,3.94,3.92,3.92,3.92,3.76,3.76,3.76,3.76,2.25,1.93,0.77,0.77,0.65,0.65,0.55,0],
    "RequestData":{"Lang":"zh_tw","Unit":"M"},
    "Summary":{"距離":"3.56","均速":"8.86"}
    "Version":"1.06.32"
  }
}

response 1

{
    "Data": {
        "SeviceName": "ITSportData",
        "Status": 1,
        "Type": "TREADMILL",
        "Result": {
            "returnMsg": "儲存成功",
            "returnCode": "0000"
        }
    }
}

request 2

 { "Data":{
    "DATETIME": "1648474664",
    "ENDTIME": "1648475375",
    "MAC": "Comapl-Dance01",
    "Type": "STAMPEDE",
    "Subtype": "燈滅",
    "SinglePadResponsTime":[0,0.6,1.08,2.26,3.47,4.48,5.73,6.75,8.75],
    "SpeedPerPad":[0,1.67,2.08,0.85,0.83,0.99,0.8,0.98,0.5],
    "Summary":{"秒數":"8.75","狀態":"後繼無力"}
  }
}

response 2

{
    "Data": {
        "SeviceName": "ITSportData",
        "Status": 1,
        "Type": "STAMPEDE",
        "Result": {
            "returnMsg": "儲存成功，無對應版本預設呈現為1.0",
            "returnCode": "0001"
        }
    }
}

格式說明討論

請參考連結 --> 格式討論

呈現方式

簡易Summary

將於單筆呈現如下圖

詳細內容呈現

請設備廠商提供網址，使用者點擊時，將上述JSON POST URL以呈現詳細內容
請提供RWD格式網頁，以利整合