API de Placares ao Vivo e Resultados:
Dados em Tempo Real para o Seu Produto
Placares, bots de alertas, portais de estatísticas e casas de apostas rodam sobre os mesmos dois feeds: placares ao vivo e resultados de partidas encerradas. Veja como eles funcionam e como integrá-los bem.
Placares e Resultados: Dois Feeds, Um Contrato de Dados
Produtos que exibem dados esportivos precisam de dois feeds distintos que costumam ser confundidos. Uma API de placares ao vivo transmite o estado das partidas em andamento — placar atual, minuto de jogo, período, cartões, jogador no saque. Uma API de resultados de partidas entrega o desfecho das partidas encerradas — placar final e detalhamento por tempos, sets, quartos e mapas. A API de Resultados de Partidas da Bet in Box cobre os dois em um único contrato: estado ao vivo enquanto a partida acontece, resultados detalhados minutos após o fim.
O que Há nos Dados
- Ao vivo: placar, fase e cronômetro da partida, eventos de momento (gols, sets, rounds) para futebol, basquete, tênis, hóquei e títulos de eSports como CS2 e Dota 2.
- Resultados: placar final, detalhamento período a período (tempos, quartos, sets, mapas) e o status de conclusão do qual a sua lógica de cálculo depende.
- Cobertura: mais de 200 esportes — o mesmo dicionário da API de Linha Esportiva, então os IDs de eventos coincidem entre os feeds e cruzar linha com resultados é um lookup, não um fuzzy match.
Latência: o Número que Define a Sua UX
Para um produto de placares ao vivo, a atualidade é o produto. A Bet in Box entrega mudanças de placar com latência de 1–3 segundos. Projete o seu polling em torno do que o usuário está vendo: atualize a partida que o usuário tem aberta a cada poucos segundos, a página da liga a cada 15–30 segundos e todo o resto sob demanda. Esse padrão mantém o volume de requisições estável enquanto os dados visíveis parecem instantâneos.
Padrões de Integração por Produto
- Portal de placares ao vivo / alternativa ao MyScore. Faça cache das partidas do dia, faça polling das partidas ao vivo, renderize a partir do seu próprio armazenamento. Também entregamos isso como uma plataforma turnkey no estilo MyScore.
- Bot de alertas. Consulte o estado ao vivo periodicamente, compare com o snapshot anterior e envie uma mensagem a cada mudança — gols, início da partida, apito final.
- Casa de apostas. Os resultados alimentam o cálculo: quando uma partida atinge o status de encerrada, solicite o resultado detalhado e calcule as apostas em aberto — ou pule essa lógica por completo e envie os cupons à API de Resultados de Apostas, que retorna ganho / perda / reembolso.
- Análises. Colete diariamente os resultados por período no seu data warehouse; uma temporada de dados detalhados é a base para modelos de previsão.
Como Começar
A documentação contém exemplos de requisições com respostas JSON reais para cada endpoint. Um teste gratuito dá acesso ao feed completo por uma semana — o suficiente para rodar um dia real de jogos pela sua integração e medir a latência você mesmo.