2023 新現代五項徵選期間 數據串接API 格式說明

新現代五項
API

本文網址QRCode

Introduction

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

設備專屬(URL/設備類別碼)

分兩階段

  • 評選期間(0508~0710):
  • 1.URL無專屬, 請帶入00000000
    2.RequestBody 則請直接以「設備商之統編」作為「設備類別碼」

  • 結果公告後(0711~1031):
  • 針對通過評選之設備商,將提供專屬URL以及文字設備類別碼

    HTTP Request:

    POST URL/設備類別碼

  • 評選期間(0508~0710):

  • 使用統編 (不管統編為何 URL 請使用8個0 )
    ex1: https://{URL}/00000000/

  • 結果公告後(0711~1031):

  • ex1: https://{URL}/PassedCompany1/
    ex2: https://{URL}/PassedCompany2/

    更新!!獲選設備 數據串接API 格式說明

    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 設備類別碼

  • 評選期間(0508~0628)
  • 請填寫設備商統編
  • 結果公告後
  • PassedCompany1
    PassedCompany2
    PassedCompany3
    Data.Summary String 20 Y 數據簡易呈現內容
    Data.Version String 20 未輸入則以0判定,不同的資料版本使用不同的UI呈現

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

    Response Body:

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

    Example:

    request 1

    {
      "Data":{
        "DATETIME": "1648474644",
        "ENDTIME": "1648475335",
        "MAC": "30AEA4982644",
        "Type": "91670788",
        "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": "91670788",
            "Result": {
                "returnMsg": "儲存成功",
                "returnCode": "0000"
            }
        }
    }
    

    request 2

     { "Data":{
        "DATETIME": "1648474664",
        "ENDTIME": "1648475375",
        "MAC": "Comapl-Dance01",
        "Type": "PassedCompany1",
        "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": "PassedCompany1",
            "Result": {
                "returnMsg": "儲存成功,無對應版本預設呈現為1.0",
                "returnCode": "0001"
            }
        }
    }
    

    呈現方式

    簡易Summary

    將於當日呈現多筆資料如下圖

    格式說明討論

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

    API 呼叫範例說明

    請參考連結 --> 呼叫範例

    詳細內容呈現

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