如果您使用的是外部計時或計分系統(例如晶片計時系統或水上運動計時平台),可以透過簡單的 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 連線
前往 Scoring Setup(計分設定),然後點選 API Integration(API 整合)分頁
點選 + 新增連線
選擇要將成績對應到的 Workout
對應您的資料點——將外部系統的欄位與 Competition Corner 中相對應的欄位配對
設定輪詢頻率——也就是 Competition Corner 從來源 API 擷取資料的頻率
測試連線
⚠️ 正式上線前請務必充分測試。您的計時服務供應商應能執行模擬,從頭到尾驗證連線。
在 Competition Corner 中快速測試的方法:
複製一個現有的 Workout
將相同的 API 設定套用到該複本
確認成績處理正確
驗證完成後刪除測試用的 Workout
請勿略過此步驟——在賽事進行期間處理計分問題壓力極大:運動員陸續完賽、排行榜持續更新,而時間不會停下來。一邊跟上進行中的賽事,一邊診斷並修復故障的 API 連線,很快就會讓人應接不暇。賽事開始前花幾分鐘測試,就能在比賽當天替您省下好幾個小時的救火時間。
成績修正
成績一旦匯入 Competition Corner,API 在之後的所有同步中都會略過該筆紀錄。這表示首次匯入後的任何成績修正,都必須直接在 Competition Corner 中進行,而非在來源系統中修改。
此行為是刻意設計的。當成績在申訴或官方複審後經過調整時,它能避免經人工審核的成績被來源系統覆寫。
成績修正的流程如下:
運動員提出申訴,或發現計分錯誤
複審成績並決定修正內容
直接在 Competition Corner 中更新修正後的成績
API 會辨識出該筆紀錄已匯入,不會覆寫修正後的成績
團體賽事注意事項
如果您在團體賽事中使用晶片計時,有兩種做法:
做法 1——每隊一個晶片 為隊伍分配一個晶片。該晶片記錄的成績會直接作為隊伍成績提交。
做法 2——每位隊員一個晶片 如果每位隊員都各自配戴晶片,Competition Corner 可以自動將各隊員的個人成績彙整為隊伍成績。若要啟用此功能,您的來源系統必須在每筆回傳的資料紀錄中包含 Teammate ID(隊友 ID),讓 Competition Corner 能將每筆成績正確對應到所屬隊伍。
此外,請確保所有隊員的成績都已計入。在所有隊員完賽前,排行榜上可能會先出現不完整的隊伍成績,導致暫時排名不正確。
