RACE RESULT 14 puede enviar webhooks cuando se producen ciertos eventos.
Estos se utilizan principalmente para asegurar la sincronización de datos entre dos almacenes de datos separados.
Por ejemplo, si estás utilizando tu propia plataforma de inscripción y deseas asegurarte de que los datos de los participantes se actualicen cuando se modifiquen en el archivo del evento.

Los webhooks se configuran en Basic Settings ⇒ Derechos de acceso/API simple.

Cada webhook debe definir el activador, la URL de destino y, para ciertos activadores, se pueden definir un filtro y campos.

Cuando se configuran y activan, los webhooks se enviarán automáticamente de acuerdo con los activadores definidos, no hay límite de tiempo durante cuánto tiempo se activarán los webhooks.

Todos los webhooks se envían como una solicitud POST con datos en el cuerpo de la POST como JSON; de forma predeterminada, el cuerpo siempre contendrá el ID del evento, el ID del webhook y la marca de tiempo; los valores adicionales dependen del activador que se utilice.

Una llamada se considera enviada exitosamente si se recibe un código de respuesta <500, incluso si el código de estado es un código de error, aún se considera recibido por el destino. Si una llamada no tiene éxito, el servidor intentará reenviarla con un retraso mayor entre o hasta que se alcance el límite de la cola del servidor, momento en el que se descartará el mensaje.

Los webhooks los envía el SES que ejecuta el archivo del evento; si está sincronizando el tiempo sin conexión, incluso con el reenvío en línea habilitado, los webhooks solo los enviará el SES local.

Impulsos

Nueva participante

Se enviará una llamada cuando se agregue un nuevo participante, esto puede ser a través de participantes importados, registro en línea, registro en el sitio o directamente a través de la ventana de participantes.

Se puede aplicar un filtro para enviar el webhook solo si un determinado filtro es verdadero, por ejemplo, si un participante ha seleccionado una opción específica durante el registro.

El cuerpo de la publicación también puede incluir cualquier campo que esté definido como una lista de valores separados por punto y coma.

Actualización del participante

De manera similar al activador de nuevo participante, la actualización del participante se enviará cada vez que se cambien los campos de datos de un registro de participante; esto no se activará por cambios en las divisiones, los cálculos de resultados o los campos definidos por el usuario.

También se puede aplicar un filtro a las actualizaciones de los participantes y el cuerpo de la publicación se puede configurar para incluir campos también.

Nuevos datos sin procesar

El nuevo activador de datos sin procesar se enviará cada vez que se agregue un nuevo registro de datos sin procesar; el registro está vinculado a un registro de participante, por lo que, opcionalmente, puede definir un filtro y campos que se incluirán en el cuerpo de la POST.

Al utilizar los nuevos datos sin procesar, se recomienda vincular el filtro a un resultado específico o al resultado final, por ejemplo; solo envíe el webhook si el participante ha finalizado. Cualquier cálculo que dependa del registro de datos sin procesar se completará primero, por lo que se enviará incluso si ese tiempo se utiliza para el resultado específico que está viendo.

Configuración cambiada

Esto se aplica a cualquier configuración del archivo de eventos que se cambie, esto incluye, por ejemplo, todas las configuraciones de eventos, sincronización de chips y puntuación en la ventana principal, actualizaciones de las listas de salida, configuraciones de my.rr y más.

Dado que la configuración se aplica al archivo del evento y no al registro de un participante, no se puede filtrar ni incluir campos adicionales. El cuerpo de la publicación incluirá ModJobID en el campo Valores para permitirle realizar un seguimiento de los cambios.

El ID de ModJob es un número entero que representa el último ciclo de cálculo ejecutado por el SES. Cada vez que se cambia algo en un archivo de eventos, se ejecuta un trabajo único que calcula lo que se debe actualizar en la base de datos. Esta identificación aumentará con cada cambio, sin importar cuán grande o pequeño sea.

Todos los cambios

Todos los cambios significa cualquier cambio en el archivo de eventos.

Dado que todos los cambios se aplican al archivo del evento y no al registro de un participante, no se pueden filtrar ni incluir campos adicionales. El cuerpo de la publicación incluirá ModJobID en el campo Valores para permitirle realizar un seguimiento de los cambios.