跳至主要內容

透過 API 即時計分

透過 API 匯入成績

作者:Michael

如果您使用的是外部計時或計分系統(例如晶片計時系統或水上運動計時平台),可以透過簡單的 API 連線,將成績即時直接推送到 Competition Corner。
​

如果您的外部系統不支援透過 API 傳送資料,請參閱匯入成績,了解手動替代方案。


事前準備

設定 API 連線前,請確認以下事項:

  • 您的外部系統能夠透過 API 傳送資料

  • 系統至少能為每筆紀錄提供一個參賽者 ID 和一個結果

  • 如果成績以時間計算,格式必須為 HH:MM:SS.000


預期的資料格式

以下是典型 API 資料酬載(JSON 格式)的範例:

json

[   
{
"First Name": "Lexi",
"Last Name": "DeSaracho",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "524658",
"CGID": "1236",
"Time": "00:13:37.2"
},
{
"First Name": "Allison",
"Last Name": "McClellan",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "527182",
"CGID": "1245",
"Time": "00:13:59.1"
}
]

兩個必填欄位為 CompCornerID(參賽者 ID)和您的結果欄位(例如 Time)。姓名、性別和隊伍等其他欄位為選填,但建議填入,以便排除問題。


設定 API 連線

  1. 前往 Scoring Setup(計分設定),然後點選 API Integration(API 整合)分頁

  2. 點選 + 新增連線

  3. 選擇要將成績對應到的 Workout

  4. 對應您的資料點——將外部系統的欄位與 Competition Corner 中相對應的欄位配對

  5. 設定輪詢頻率——也就是 Competition Corner 從來源 API 擷取資料的頻率


測試連線

⚠️ 正式上線前請務必充分測試。您的計時服務供應商應能執行模擬,從頭到尾驗證連線。

在 Competition Corner 中快速測試的方法:

  1. 複製一個現有的 Workout

  2. 將相同的 API 設定套用到該複本

  3. 確認成績處理正確

  4. 驗證完成後刪除測試用的 Workout

請勿略過此步驟——在賽事進行期間處理計分問題壓力極大:運動員陸續完賽、排行榜持續更新,而時間不會停下來。一邊跟上進行中的賽事,一邊診斷並修復故障的 API 連線,很快就會讓人應接不暇。賽事開始前花幾分鐘測試,就能在比賽當天替您省下好幾個小時的救火時間。


成績修正

成績一旦匯入 Competition Corner,API 在之後的所有同步中都會略過該筆紀錄。這表示首次匯入後的任何成績修正,都必須直接在 Competition Corner 中進行,而非在來源系統中修改。

此行為是刻意設計的。當成績在申訴或官方複審後經過調整時,它能避免經人工審核的成績被來源系統覆寫。
​

成績修正的流程如下:

  1. 運動員提出申訴,或發現計分錯誤

  2. 複審成績並決定修正內容

  3. 直接在 Competition Corner 中更新修正後的成績

  4. API 會辨識出該筆紀錄已匯入,不會覆寫修正後的成績


團體賽事注意事項

如果您在團體賽事中使用晶片計時,有兩種做法:

做法 1——每隊一個晶片 為隊伍分配一個晶片。該晶片記錄的成績會直接作為隊伍成績提交。

做法 2——每位隊員一個晶片 如果每位隊員都各自配戴晶片,Competition Corner 可以自動將各隊員的個人成績彙整為隊伍成績。若要啟用此功能,您的來源系統必須在每筆回傳的資料紀錄中包含 Teammate ID(隊友 ID),讓 Competition Corner 能將每筆成績正確對應到所屬隊伍。

此外,請確保所有隊員的成績都已計入。在所有隊員完賽前,排行榜上可能會先出現不完整的隊伍成績,導致暫時排名不正確。


相關文章

是否回答了您的問題?