Si vous travaillez avec un système externe de chronométrage ou de scoring — comme un système de chronométrage par puce ou une plateforme de chronométrage pour les sports aquatiques —, vous pouvez envoyer les scores directement dans Competition Corner en temps réel grâce à une simple connexion API.
Si votre système externe ne prend pas en charge la transmission de données par API, consultez Importer des scores pour une alternative manuelle.
Prérequis
Avant de configurer la connexion API, vérifiez les points suivants :
Votre système externe est capable de transmettre des données via une API
Le système peut fournir, au minimum, un identifiant de participant et un résultat par entrée
Si les scores sont basés sur le temps, ils doivent être au format HH:MM:SS.000
Format de données attendu
Voici un exemple de payload API typique au format 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"
}
]
Les deux champs obligatoires sont CompCornerID (l'identifiant du participant) et votre champ de résultat (par ex. Time). Les champs supplémentaires tels que le nom, le genre et l'équipe sont facultatifs, mais recommandés pour faciliter le dépannage.
Configurer votre connexion API
Accédez à Scoring Setup (configuration du scoring) et cliquez sur l'onglet API Integration (intégration API)
Cliquez sur + pour ajouter une nouvelle connexion
Sélectionnez le workout auquel vous souhaitez associer les scores
Mappez vos points de données — faites correspondre les champs de votre système externe aux champs correspondants dans Competition Corner
Définissez la fréquence d'interrogation — c'est-à-dire la fréquence à laquelle Competition Corner doit récupérer les données depuis l'API source
Tester votre connexion
⚠️ Testez minutieusement avant de passer en direct. Votre prestataire de chronométrage doit pouvoir lancer une simulation afin de valider la connexion de bout en bout.
Une méthode rapide pour tester dans Competition Corner :
Dupliquez un workout existant
Appliquez les mêmes paramètres API au duplicata
Vérifiez que les scores sont traités correctement
Supprimez le workout de test une fois la validation effectuée
Ne sautez pas cette étape – Résoudre des problèmes de scoring pendant un événement en direct est extrêmement stressant : les athlètes terminent, les classements se mettent à jour et le chrono ne s'arrête pas. Essayer de diagnostiquer et de réparer une connexion API défaillante tout en suivant le rythme d'un événement en cours peut vite devenir ingérable. Quelques minutes de test avant le début de votre événement peuvent vous épargner des heures à éteindre des incendies le jour de la compétition.
Corrections de scores
Une fois qu'un score a été importé dans Competition Corner, l'API ignore cet enregistrement lors de toutes les synchronisations suivantes. Cela signifie que toute correction de score après l'importation initiale doit être effectuée directement dans Competition Corner — et non dans le système source.
Ce comportement est volontaire. Il évite que des scores vérifiés manuellement soient écrasés par le système source lorsqu'un résultat a été ajusté à la suite d'un appel ou d'un examen officiel.
Le processus de correction des scores est le suivant :
Un athlète dépose un appel ou une erreur de scoring est identifiée
Le score est examiné et une correction est décidée
Le score corrigé est mis à jour directement dans Competition Corner
L'API reconnaîtra que l'enregistrement a déjà été importé et n'écrasera pas le score corrigé
Points à considérer pour les événements par équipes
Si vous utilisez le chronométrage par puce pour des événements par équipes, deux approches sont possibles :
Option 1 — Une puce par équipe Attribuez une seule puce à l'équipe. Le score enregistré par cette puce est soumis directement comme résultat de l'équipe.
Option 2 — Une puce par membre de l'équipe Si chaque membre de l'équipe porte sa propre puce, Competition Corner peut regrouper automatiquement les scores individuels des membres en un score d'équipe. Pour activer cette fonction, votre système source doit inclure le Teammate ID (identifiant du coéquipier) dans chaque enregistrement de données renvoyé, afin que Competition Corner puisse associer correctement chaque score à la bonne équipe.
Assurez-vous également que les scores de tous les membres de l'équipe sont bien pris en compte. Un score d'équipe partiel peut apparaître dans le classement avant que tous les membres aient terminé, ce qui peut entraîner des classements intermédiaires incorrects.
