No centro da camada de temporização estão os dispositivos, as sessões e as passagens:
- Um dispositivo é qualquer hardware ou software capaz de detectar um competidor em um ponto específico — normalmente lendo um número de peito ou chip e atribuindo-lhe um carimbo de data/hora.
- Uma sessão é criada por um dispositivo para agrupar um conjunto de passagens durante uma operação de temporização específica.
- Uma passagem representa um único evento registrado: um identificador de competidor e um carimbo de data/hora gerado por um dispositivo.
O fluxo típico é simples:
um dispositivo autentica usando uma chave API → cria uma sessão → envia passagens para essa sessão.
Acima dessa camada de ingestão, o API agora expõe um modelo de dados de evento e participante, permitindo integrações mais profundas:
- Um evento representa uma corrida ou competição gerenciada dentro do ecossistema RUFUS.
- Participantes são os competidores inscritos em um evento, incluindo seus identificadores (número de peito, chip, etc.) e dados associados.
Isso permite que sistemas externos não apenas enviem dados de tempo, mas também consumam e gerenciem informações relacionadas a eventos, como listar eventos, recuperar participantes ou criar novos registros de participantes (dependendo das permissões-chave API).
Antes de interagir com qualquer um desses recursos, o acesso deve ser concedido por meio de uma chave API, que define o nível de permissões (leitura, gravação ou ambos) disponíveis para sua integração.
Juntos, esses componentes fornecem um fluxo de trabalho completo — desde a captura de dados brutos de cronometragem em campo até a integração de informações de eventos estruturadas na nuvem.