Se lavori con un sistema esterno di cronometraggio o di punteggio — come un sistema di cronometraggio a chip o una piattaforma di cronometraggio per sport acquatici — puoi inviare i punteggi direttamente a Competition Corner in tempo reale tramite una semplice connessione API.
Se il tuo sistema esterno non supporta l'invio dei dati tramite API, consulta Importare i punteggi per un'alternativa manuale.
Prerequisiti
Prima di configurare la connessione API, verifica quanto segue:
Il tuo sistema esterno è in grado di inviare dati tramite un'API
Il sistema può fornire, come minimo, un ID partecipante e un risultato per ogni voce
Se i punteggi sono basati sul tempo, devono essere nel formato HH:MM:SS.000
Formato dei dati previsto
Di seguito trovi un esempio di come appare un tipico payload API in formato 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"
}
]
I due campi obbligatori sono CompCornerID (l'ID del partecipante) e il tuo campo del risultato (ad es. Time). I campi aggiuntivi come nome, genere e squadra sono facoltativi ma consigliati per semplificare la risoluzione dei problemi.
Configurare la connessione API
Vai su Scoring Setup (configurazione del punteggio) e fai clic sulla scheda API Integration (integrazione API)
Fai clic su + per aggiungere una nuova connessione
Seleziona il workout a cui vuoi associare i punteggi
Mappa i tuoi dati — abbina i campi del tuo sistema esterno ai campi corrispondenti in Competition Corner
Imposta la frequenza di polling — ogni quanto Competition Corner deve recuperare i dati dall'API di origine
Testare la connessione
⚠️ Esegui test approfonditi prima di andare live. Il tuo fornitore del cronometraggio dovrebbe essere in grado di eseguire una simulazione per convalidare la connessione end-to-end.
Un modo rapido per testare all'interno di Competition Corner:
Duplica un workout esistente
Applica le stesse impostazioni API al duplicato
Verifica che i punteggi vengano elaborati correttamente
Elimina il workout di prova una volta convalidato
Non saltare questo passaggio – Risolvere problemi di punteggio durante un evento live è estremamente stressante: gli atleti stanno finendo, le classifiche si aggiornano e il cronometro non si ferma. Cercare di diagnosticare e riparare una connessione API non funzionante mentre si tiene il passo con un evento in corso può diventare rapidamente ingestibile. Pochi minuti di test prima dell'inizio dell'evento possono farti risparmiare ore di emergenze il giorno della competizione.
Correzioni dei punteggi
Una volta che un punteggio è stato importato in Competition Corner, l'API salterà quel record in tutte le sincronizzazioni successive. Ciò significa che qualsiasi correzione del punteggio dopo l'importazione iniziale deve essere effettuata direttamente in Competition Corner, non nel sistema di origine.
Questo comportamento è intenzionale. Protegge i punteggi revisionati manualmente dall'essere sovrascritti dal sistema di origine nei casi in cui un risultato sia stato modificato in seguito a un ricorso o a una revisione ufficiale.
Il flusso di lavoro per le correzioni dei punteggi è:
Un atleta presenta un ricorso oppure viene individuato un errore di punteggio
Il punteggio viene revisionato e viene stabilita una correzione
Il punteggio corretto viene aggiornato direttamente in Competition Corner
L'API riconoscerà che il record è già stato importato e non sovrascriverà il punteggio corretto
Considerazioni per gli eventi a squadre
Se utilizzi il cronometraggio a chip per eventi a squadre, hai due possibilità:
Opzione 1 — Un chip per squadra Assegna un unico chip alla squadra. Il punteggio registrato da quel chip viene inviato direttamente come risultato della squadra.
Opzione 2 — Un chip per ogni membro della squadra Se ogni membro della squadra ha il proprio chip, Competition Corner può aggregare automaticamente i punteggi dei singoli membri in un punteggio di squadra. Per abilitare questa funzione, il tuo sistema di origine deve includere il Teammate ID (ID del compagno di squadra) in ogni record di dati restituito, in modo che Competition Corner possa associare correttamente ogni punteggio alla squadra giusta.
Assicurati inoltre che i punteggi di tutti i membri della squadra siano conteggiati. Un punteggio di squadra parziale può comparire in classifica prima che tutti i membri abbiano terminato, causando posizioni provvisorie errate.
