RACE RESULT 14 kann so eingerichtet werden, dass es bei bestimmten Auslösern einen Webhook sendet. Diese werden in erster Linie verwendet, um die Synchronisierung von Daten zwischen zwei getrennten Datenspeichern zu gewährleisten, z. B. wenn Sie Ihre eigene Registrierungsplattform verwenden und sicherstellen möchten, dass die Teilnehmerdaten aktualisiert werden, wenn sie in der Veranstaltungsdatei geändert werden.

Webhooks werden unter Grundeinstellungen ⇒ Zugriffsrechte / Freigabe.

Für jeden Webhook müssen der Auslöser und die Ziel-URL definiert werden, und für bestimmte Auslöser können ein Filter und Felder definiert werden. 

Wenn die Webhooks eingerichtet und aktiviert sind, werden sie automatisch entsprechend den definierten Auslösern versendet; es gibt keine zeitliche Begrenzung, wie lange Webhooks aktiviert werden. 

Alle Webhooks werden als POST-Anfrage mit Daten im POST-Body als JSON gesendet, standardmäßig enthält der Body immer die Ereignis-ID, die Webhook-ID und den Zeitstempel, zusätzliche Werte hängen vom verwendeten Trigger ab. 

Ein Aufruf gilt als erfolgreich gesendet, wenn ein Antwortcode <500 empfangen wird, auch wenn der Statuscode ein Fehlercode ist, wird er als vom Ziel empfangen betrachtet. Wenn ein Aufruf nicht erfolgreich war, versucht der Server, ihn mit einer längeren Verzögerung erneut zu senden, bis die Warteschlangengrenze des Servers erreicht ist, woraufhin die Nachricht verworfen wird. 

Webhooks werden von dem SES gesendet, das die Ereignisdatei ausführt. Wenn Sie zeitlich offline sind, werden die Webhooks auch bei aktivierter Online-Weiterleitung nur von Ihrem lokalen SES gesendet. 

Trigger

Neuer Teilnehmer

Ein Anruf wird gesendet, wenn ein neuer Teilnehmer hinzugefügt wird. Dies kann entweder über den Import von Teilnehmern, die Online-Registrierung, die Registrierung vor Ort oder direkt über das Teilnehmerfenster erfolgen. 

Es kann ein Filter angewendet werden, um den Webhook nur zu senden, wenn ein bestimmter Filter zutrifft, z. B. wenn ein Teilnehmer bei der Registrierung eine bestimmte Option ausgewählt hat. 

Der Nachrichtentext kann auch beliebige Felder enthalten, die als eine Liste von durch Semikolon getrennten Werten definiert sind. 

Teilnehmer-Update

Ähnlich wie der Auslöser für neue Teilnehmer wird die Teilnehmeraktualisierung immer dann gesendet, wenn die Datenfelder eines Teilnehmerdatensatzes geändert werden. Dies wird nicht durch Änderungen an Splits, Ergebnisberechnungen oder benutzerdefinierten Feldern ausgelöst.

Auch auf Teilnehmer-Updates kann ein Filter angewendet werden und der Post-Body kann so konfiguriert werden, dass er auch Felder enthält. 

Neue Rohdaten

Der Auslöser für neue Rohdaten wird immer dann gesendet, wenn ein neuer Rohdatensatz hinzugefügt wird. Der Datensatz ist mit einem Teilnehmerdatensatz verknüpft, so dass Sie optional einen Filter und Felder definieren können, die in den POST-Body aufgenommen werden. 

Bei der Verwendung von neuen Rohdaten ist es empfehlenswert, den Filter mit einem bestimmten Ergebnis oder dem Ergebnis "Beendet" zu verknüpfen, z. B. den Webhook nur zu senden, wenn der Teilnehmer "Beendet" ist. Alle Berechnungen, die von dem Rohdatensatz abhängen, werden zuerst abgeschlossen, so dass der Webhook auch dann gesendet wird, wenn diese Zeit für das spezifische Ergebnis, das Sie betrachten, verwendet wird. 

Geänderte Einstellungen

Dies gilt für alle geänderten Einstellungen in der Ereignisdatei, z. B. alle Einstellungen für das Ereignis, die Chip-Zeitnahme und die Wertung im Hauptfenster, Aktualisierungen der Ausgabelisten, my.rr-Einstellungen und mehr.

Da sich die Einstellungen auf die Veranstaltungsdatei und nicht auf einen Teilnehmerdatensatz beziehen, können sie nicht gefiltert werden oder zusätzliche Felder enthalten. Der Post-Body enthält die ModJobID im Feld Werte, damit Sie die Änderungen nachvollziehen können. 

Die ModJob-ID ist eine ganze Zahl, die den letzten vom SES durchgeführten Berechnungszyklus angibt. Jedes Mal, wenn etwas in einer Ereignisdatei geändert wird, wird ein eindeutiger Job ausgeführt, der berechnet, was in der Datenbank aktualisiert werden sollte. Diese ID erhöht sich bei jeder Änderung, egal wie groß oder klein sie ist. 

Alle Änderungen

Alle Änderungen bedeutet jede Änderung an der Ereignisdatei. 

Da sich die Option "Alle Änderungen" auf die Veranstaltungsdatei und nicht auf einen Teilnehmerdatensatz bezieht, kann sie nicht gefiltert werden oder zusätzliche Felder enthalten. Der Beitragstext enthält die ModJobID im Feld Werte, damit Sie die Änderungen verfolgen können.