Ir para conteúdo principal

Pontuação em tempo real via API

Importar resultados via API

Escrito por Michael

Se você trabalha com um sistema externo de cronometragem ou pontuação — como um sistema de cronometragem por chip ou uma plataforma de cronometragem para esportes aquáticos —, pode enviar os resultados diretamente para o Competition Corner em tempo real por meio de uma conexão de API simples.
​

Se o seu sistema externo não oferece suporte ao envio de dados por API, consulte Importar resultados para uma alternativa manual.


Pré-requisitos

Antes de configurar a conexão de API, confirme o seguinte:

  • Seu sistema externo é capaz de enviar dados por meio de uma API

  • O sistema consegue fornecer, no mínimo, um ID do participante e um resultado por registro

  • Se os resultados forem baseados em tempo, devem estar no formato HH:MM:SS.000


Formato de dados esperado

Veja abaixo um exemplo de como é um payload de API típico em formato JSON:

json

[   
{
"First Name": "Lexi",
"Last Name": "DeSaracho",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "524658",
"CGID": "1236",
"Time": "00:13:37.2"
},
{
"First Name": "Allison",
"Last Name": "McClellan",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "527182",
"CGID": "1245",
"Time": "00:13:59.1"
}
]

Os dois campos obrigatórios são CompCornerID (o ID do participante) e o seu campo de resultado (por exemplo, Time). Campos adicionais, como nome, gênero e equipe, são opcionais, mas recomendados para facilitar a solução de problemas.


Configurando sua conexão de API

  1. Acesse Scoring Setup (configuração de pontuação) e clique na aba API Integration (integração de API)

  2. Clique em + para adicionar uma nova conexão

  3. Selecione o workout ao qual você deseja associar os resultados

  4. Mapeie seus pontos de dados — associe os campos do seu sistema externo aos campos correspondentes no Competition Corner

  5. Defina a frequência de consulta — com que frequência o Competition Corner deve buscar dados da API de origem


Testando sua conexão

⚠️ Teste minuciosamente antes de entrar ao vivo. Seu fornecedor de cronometragem deve ser capaz de executar uma simulação para validar a conexão de ponta a ponta.

Uma forma rápida de testar dentro do Competition Corner:

  1. Duplique um workout existente

  2. Aplique as mesmas configurações de API à cópia

  3. Confirme que os resultados estão sendo processados corretamente

  4. Exclua o workout de teste depois de validado

Não pule esta etapa – Resolver problemas de pontuação durante um evento ao vivo é extremamente estressante: os atletas estão terminando, as classificações estão sendo atualizadas e o relógio não para. Tentar diagnosticar e corrigir uma conexão de API com falha enquanto acompanha um evento em andamento pode rapidamente se tornar sufocante. Alguns minutos de teste antes do início do seu evento podem poupar horas apagando incêndios no dia da competição.


Correções de resultados

Depois que um resultado é importado para o Competition Corner, a API ignora esse registro em todas as sincronizações seguintes. Isso significa que qualquer correção de resultado após a importação inicial deve ser feita diretamente no Competition Corner — e não no sistema de origem.

Esse comportamento é intencional. Ele impede que resultados revisados manualmente sejam sobrescritos pelo sistema de origem nos casos em que um resultado foi ajustado após um recurso ou uma revisão oficial.
​

O fluxo para correções de resultados é:

  1. Um atleta envia um recurso ou um erro de pontuação é identificado

  2. O resultado é revisado e uma correção é definida

  3. O resultado corrigido é atualizado diretamente no Competition Corner

  4. A API reconhecerá que o registro já foi importado e não sobrescreverá o resultado corrigido


Considerações para eventos em equipe

Se você usa cronometragem por chip em eventos em equipe, há duas abordagens:

Opção 1 — Um chip por equipe Atribua um único chip à equipe. O resultado registrado por esse chip é enviado diretamente como o resultado da equipe.

Opção 2 — Um chip por integrante da equipe Se cada integrante da equipe usar seu próprio chip, o Competition Corner pode agregar automaticamente os resultados individuais dos integrantes em um resultado da equipe. Para habilitar isso, seu sistema de origem deve incluir o Teammate ID (ID do colega de equipe) em cada registro de dados retornado, para que o Competition Corner possa associar corretamente cada resultado à equipe certa.

Além disso, garanta que os resultados de todos os integrantes da equipe sejam contabilizados. Um resultado parcial da equipe pode aparecer na classificação antes que todos os integrantes tenham terminado, o que pode gerar posições parciais incorretas.


Artigos relacionados

Isto respondeu à sua pergunta?