Wenn Sie mit einem externen Zeitmess- oder Scoring-System arbeiten – etwa einem Chip-Zeitmesssystem oder einer Zeitmessplattform für den Wassersport –, können Sie Scores über eine einfache API-Verbindung in Echtzeit direkt an Competition Corner übertragen.
Falls Ihr externes System keine Datenübermittlung per API unterstützt, finden Sie unter Scores importieren eine manuelle Alternative.
Voraussetzungen
Bevor Sie die API-Verbindung einrichten, prüfen Sie bitte Folgendes:
Ihr externes System kann Daten über eine API bereitstellen
Das System kann pro Eintrag mindestens eine Teilnehmer-ID und ein Ergebnis liefern
Zeitbasierte Scores müssen im Format HH:MM:SS.000 vorliegen
Erwartetes Datenformat
Unten sehen Sie ein Beispiel dafür, wie eine typische API-Payload im JSON-Format aussieht:
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"
}
]
Die beiden Pflichtfelder sind CompCornerID (die Teilnehmer-ID) und Ihr Ergebnisfeld (z. B. Time). Zusätzliche Felder wie Name, Geschlecht und Team sind optional, werden aber empfohlen, um die Fehlersuche zu erleichtern.
API-Verbindung einrichten
Navigieren Sie zu Scoring Setup (Scoring-Einrichtung) und klicken Sie auf den Tab API Integration (API-Integration)
Klicken Sie auf +, um eine neue Verbindung hinzuzufügen
Wählen Sie das Workout aus, dem die Scores zugeordnet werden sollen
Ordnen Sie Ihre Datenpunkte zu – verknüpfen Sie die Felder Ihres externen Systems mit den entsprechenden Feldern in Competition Corner
Legen Sie die Abfragehäufigkeit fest – wie oft Competition Corner Daten von der Quell-API abrufen soll
Verbindung testen
⚠️ Testen Sie gründlich, bevor Sie live gehen. Ihr Zeitmessanbieter sollte eine Simulation durchführen können, um die Verbindung durchgängig zu validieren.
So können Sie schnell innerhalb von Competition Corner testen:
Duplizieren Sie ein bestehendes Workout
Übernehmen Sie dieselben API-Einstellungen für das Duplikat
Überprüfen Sie, ob die Scores korrekt verarbeitet werden
Löschen Sie das Test-Workout nach erfolgreicher Validierung
Überspringen Sie diesen Schritt nicht – Scoring-Probleme während eines Live-Events zu beheben, ist extrem stressig: Athleten kommen ins Ziel, Leaderboards werden aktualisiert und die Uhr bleibt nicht stehen. Eine fehlerhafte API-Verbindung zu analysieren und zu reparieren, während Sie gleichzeitig mit dem laufenden Event Schritt halten müssen, kann schnell überwältigend werden. Ein paar Minuten Testen vor Beginn Ihres Events können Ihnen am Wettkampftag stundenlanges Krisenmanagement ersparen.
Score-Korrekturen
Sobald ein Score in Competition Corner importiert wurde, überspringt die API diesen Datensatz bei allen nachfolgenden Synchronisierungen. Das bedeutet, dass alle Score-Korrekturen nach dem ersten Import direkt in Competition Corner vorgenommen werden müssen – nicht im Quellsystem.
Dieses Verhalten ist beabsichtigt. Es schützt manuell geprüfte Scores davor, vom Quellsystem überschrieben zu werden, wenn ein Ergebnis nach einem Einspruch oder einer offiziellen Prüfung angepasst wurde.
Der Ablauf für Score-Korrekturen ist wie folgt:
Ein Athlet reicht einen Einspruch ein oder ein Scoring-Fehler wird festgestellt
Der Score wird geprüft und eine Korrektur wird festgelegt
Der korrigierte Score wird direkt in Competition Corner aktualisiert
Die API erkennt, dass der Datensatz bereits importiert wurde, und überschreibt den korrigierten Score nicht
Hinweise für Team-Events
Wenn Sie Chip-Zeitmessung für Team-Events verwenden, haben Sie zwei Möglichkeiten:
Option 1 – Ein Chip pro Team Weisen Sie dem Team einen einzigen Chip zu. Der von diesem Chip erfasste Score wird direkt als Ergebnis des Teams übermittelt.
Option 2 – Ein Chip pro Teammitglied Wenn jedes Teammitglied einen eigenen Chip trägt, kann Competition Corner die einzelnen Scores der Mitglieder automatisch zu einem Team-Score zusammenfassen. Damit dies funktioniert, muss Ihr Quellsystem mit jedem zurückgegebenen Datensatz die Teammate ID (ID des Teammitglieds) mitliefern, damit Competition Corner jeden Score korrekt dem richtigen Team zuordnen kann.
Stellen Sie außerdem sicher, dass die Scores aller Teammitglieder erfasst sind. Ein unvollständiger Team-Score kann im Leaderboard erscheinen, bevor alle Mitglieder fertig sind, was zu falschen Zwischenständen führen kann.
