En el corazón de la capa de temporización se encuentran los dispositivos, las sesiones y los pasos:
- Un dispositivo es cualquier hardware o software capaz de detectar a un competidor en un punto específico, normalmente leyendo un número de dorsal o un chip y asignándole una marca de tiempo.
- Un dispositivo crea una sesión para agrupar un conjunto de pasadas durante una operación de cronometraje específica.
- Un paso representa un único evento registrado: un identificador de competidor y una marca de tiempo generada por un dispositivo.
El flujo típico es simple:
un dispositivo se autentica usando una clave API → crea una sesión → envía pases a esa sesión.
Sobre esta capa de ingesta, el API ahora expone un modelo de datos de eventos y participantes, lo que permite integraciones más profundas:
- Un evento representa una carrera o competición gestionada dentro del ecosistema RUFUS.
- Los participantes son los competidores inscritos en un evento, incluidos sus identificadores (dorsal, chip, etc.) y los datos asociados.
Esto permite que los sistemas externos no solo envíen datos de tiempo, sino que también consuman y gestionen información relacionada con eventos, como la lista de eventos, la recuperación de participantes o la creación de nuevos registros de participantes (dependiendo de los permisos clave de API).
Antes de interactuar con cualquiera de estos recursos, se debe conceder el acceso a través de una clave API, que define el nivel de permisos (lectura, escritura o ambos) disponibles para su integración.
En conjunto, estos componentes proporcionan un flujo de trabajo completo, desde la captura de datos de tiempo sin procesar en el campo hasta la integración de información de eventos estructurada en la nube.