RACE RESULT 14 peut envoyer des webhooks lors de certains déclencheurs. Ceux-ci sont principalement utilisés pour assurer la synchronisation des données entre deux bases de données distinctes. Par exemple, si vous utilisez votre propre plateforme d'inscription et que vous souhaitez vous assurer que les données des participants sont mises à jour lorsqu'elles sont modifiées dans le fichier de l'événement. 

Les webhooks sont configurés dans les Paramètres généraux - Droits d'accès / API simple.

Chaque webhook doit définir le déclencheur, l'URL de destination et, pour certains déclencheurs, un filtre et des champs peuvent être définis. 

Une fois configurés et activés, les webhooks seront automatiquement envoyés en fonction des déclencheurs définis. Il n'y a pas de limite de temps pour l'activation des webhooks. 

Tous les webhooks sont envoyés sous forme de requête POST avec les données dans le corps POST au format JSON. Par défaut, le corps contient toujours l'ID de l'événement, l'ID du webhook, l'horodatage et des valeurs supplémentaires en fonction du déclencheur utilisé. 

Un appel est considéré comme envoyé avec succès si un code de réponse <500 est reçu. Même si le code d'état est un code d'erreur, il est toujours considéré comme reçu par la destination. Si un appel échoue, le serveur tentera de le renvoyer avec un délai accru entre les tentatives ou jusqu'à ce que la limite de la file d'attente du serveur soit atteinte, auquel cas le message sera supprimé. 

Les webhooks sont envoyés par le SES qui exécute le fichier d'événement. Si vous êtes hors ligne, même si le transfert en ligne est activé, les webhooks ne seront envoyés que par votre SES local. 

Déclencheurs

Nouveau participant

Un appel sera envoyé lorsqu'un nouveau participant sera ajouté, que ce soit par importation, inscription en ligne, inscription sur place ou directement via la fenêtre des participants. 

Un filtre peut être appliqué pour n'envoyer le webhook que si un certain filtre est vrai, par exemple si un participant a sélectionné une option spécifique lors de son inscription. 

Le corps du message peut également inclure tous les champs définis comme une liste de valeurs séparées par des points-virgules. 

Mise à jour des participants

Tout comme le déclencheur « Nouveau participant », la mise à jour des participants sera envoyée chaque fois que les champs de données d'un enregistrement de participant seront modifiés. Elle ne sera pas déclenchée par des modifications apportées aux divisions, aux calculs de résultats ou aux champs définis par l'utilisateur.

Un filtre peut également être appliqué aux mises à jour des participants et le corps du message peut être configuré pour inclure des champs. 

Nouvelles données brutes

Le déclencheur de nouvelles données brutes sera envoyé chaque fois qu'un nouvel enregistrement de données brutes sera ajouté. L'enregistrement est lié à un enregistrement de participant, vous pouvez donc définir un filtre et des champs à inclure dans le corps du message POST. 

Lorsque vous utilisez les nouvelles données brutes, il est recommandé de lier le filtre à un résultat spécifique ou au résultat « Terminé », par exemple : n'envoyer le webhook que si le participant a terminé. Tous les calculs qui dépendent de l'enregistrement des données brutes seront effectués en premier, de sorte qu'il sera envoyé même si ce temps est utilisé pour le résultat spécifique que vous consultez. 

Paramètres modifiés

Cela s'applique à tous les paramètres du fichier d'événement qui sont modifiés, y compris, par exemple, tous les paramètres Événement, Chronométrage et Notation dans la fenêtre principale, les mises à jour des listes de sortie, les paramètres my.rr, etc.

Étant donné que les paramètres s'appliquent au fichier d'événement et non à un enregistrement de participant, ils ne peuvent pas être filtrés ni inclure de champs supplémentaires. Le corps du message inclura le ModJobID dans le champ Valeurs pour vous permettre de suivre les modifications. 

Le ModJob ID est un nombre entier qui représente le dernier cycle de calcul exécuté par le SES. Chaque fois qu'une modification est apportée à un fichier d'événement, une tâche unique est exécutée pour calculer les éléments à mettre à jour dans la base de données. Cet ID augmente à chaque modification, quelle que soit son importance. 

Toutes les modifications

Toutes les modifications désignent toute modification apportée au fichier d'événement. 

Étant donné que toutes les modifications s'appliquent au fichier d'événement et non à un enregistrement de participant, elles ne peuvent pas être filtrées ni inclure des champs supplémentaires. Le corps du message inclura le ModJobID dans le champ Valeurs afin de vous permettre de suivre les modifications.