RACE RESULT 14 può essere configurato per inviare un Webhook su determinati trigger: questi sono principalmente utilizzati per garantire la sincronizzazione dei dati tra due archivi dati separati, ad esempio se si utilizza la propria piattaforma di registrazione e si desidera garantire che i dati dei partecipanti vengano aggiornati se viene modificato nel file evento.
I Webhook sono configurabili in Impostazioni Gernerali ⇒ Diritti di accesso/API semplici.
Ciascun Webhook deve definire il trigger, l'URL di destinazione e, per alcuni trigger, è possibile definire un filtro e campi.
Una volta configurati e attivati, i Webhook verranno inviati automaticamente in base ai trigger definiti: non vi è alcun limite di tempo per la durata dell'attivazione dei Webhook.
Tutti i Webhook vengono inviati come richiesta POST, con i dati nel corpo POST come JSON; per impostazione predefinita il corpo conterrà sempre ID evento, ID Webhook, timestamp e valori aggiuntivi dipendenti dal trigger utilizzato.
Una chiamata si considera inviata con successo se viene ricevuto un codice di risposta <500: anche se il codice di stato è un codice di errore, questo viene considerato ricevuto dalla destinazione. Se una chiamata non riesce, il server tenterà di inviarla nuovamente con un ritardo maggiore tra l'una e l'altra chiamata o fino al raggiungimento del limite della coda del server: solo a questo punto il messaggio verrà eliminato.
I Webhook vengono inviati dal SES che esegue il file dell'evento; se stai cronometrando offline, anche con l'inoltro online abilitato, i webhook verranno inviati solo dal tuo SES locale.
Triggers
Nuovo partecipante
Quando viene aggiunto un nuovo partecipante, sia questo aggiunto attraverso l'importazione di partecipanti, la registrazione online, la registrazione in loco o direttamente tramite la finestra dei partecipanti, viene inviata una chiamata.
È possibile applicare un filtro per inviare il Webhook solo se un determinato filtro è VERO, ad esempio se un partecipante ha selezionato un'opzione specifica durante la registrazione.
Il corpo del POST può anche includere qualsiasi campo definito come un elenco di valori separati da punto e virgola.
Aggiornamento partecipante
Simile al trigger del nuovo partecipante, l'aggiornamento del partecipante verrà inviato ogni volta che i campi dati di un record del partecipante vengono modificati: questo non succede se vengono invece effettuate modifiche agli intermedi, ai calcoli dei risultati o ai campi definiti dall'utente.
Un filtro può essere applicato anche agli aggiornamenti dei partecipanti e il corpo del POST può essere configurato per includere anche i campi.
Nuovo dato grezzo
Il nuovo trigger di dati grezzi verrà inviato ogni volta che viene aggiunto un nuovo record di dati non elaborati: il record è collegato a un record del partecipante in modo che sia possibile definire facoltativamente un filtro e campi da includere nel corpo del POST.
Quando si utilizzano i nuovi dati grezzi, si consiglia di collegare il filtro ad un risultato specifico o al risultato finale, ad esempio, inviando il Webhook solo se il partecipante ha terminato la sua corsa. Tutti i calcoli che dipendono dal record di dati grezzi verranno completati per primi, quindi verrà inviato anche se quel tempo viene utilizzato per il risultato specifico che stai guardando.
Cambio Impostazioni
Questo vale per tutte le impostazioni del file di evento che vengono modificate: questo include ad esempio tutte le impostazioni presenti nelle sottosezioni di Evento, Cronometraggio con Chip e Impostazioni Punteggio presenti nella Finestra Principale, negli aggiornamenti agli elenchi di output, nelle impostazioni my.rr e altro.
Poiché le impostazioni si applicano al file dell'evento e non al record del partecipante, non è possibile filtrarlo o includere campi aggiuntivi. Il corpo del post includerà il ModJobID nel campo Valori, per consentirti di tenere traccia delle modifiche.
L'ID ModJob è un numero intero che rappresenta l'ultimo ciclo di calcolo eseguito dal SES. Ogni volta che qualcosa viene modificato in un file evento, viene eseguito un lavoro univoco che calcola cosa dovrebbe essere aggiornato nel database. Questo ID aumenterà per ogni modifica, non importa quanto grande o piccola.
Tutti i cambiamenti
Tutte le modifiche indicano qualsiasi modifica al file dell'evento.
Poiché tutte le modifiche si applicano al file Evento e non a un record del partecipante, non è possibile filtrare o includere campi aggiuntivi. Il corpo del post includerà il ModJobID nel campo Valori per consentirti di tenere traccia delle modifiche.