API live-счетов и результатов матчей:
данные в реальном времени для вашего продукта
Табло, боты-уведомления, статистические порталы и букмекерские платформы работают на одних и тех же двух фидах: live-счета и результаты завершённых матчей. Рассказываем, как они устроены и как их правильно интегрировать.
Счета и результаты: два фида, один контракт данных
Продуктам, которые показывают спортивные данные, нужны два разных фида, которые часто путают. API live-счетов транслирует состояние идущих матчей — текущий счёт, минуту матча, период, карточки, подающего игрока. API результатов матчей отдаёт итоги завершённых матчей — финальный счёт плюс детальную разбивку по таймам, сетам, четвертям и картам. API результатов матчей Bet in Box покрывает оба сценария одним договором: live-состояние, пока матч идёт, и детальные результаты через несколько минут после его окончания.
Что входит в данные
- Live: счёт, фаза матча и таймер, ключевые события (голы, сеты, раунды) для футбола, баскетбола, тенниса, хоккея и киберспортивных дисциплин вроде CS2 и Dota 2.
- Результаты: финальный счёт, детализация по периодам (таймы, четверти, сеты, карты) и статус завершения, от которого зависит ваша логика расчёта ставок.
- Охват: 200+ видов спорта — тот же справочник, что и в API спортивной линии, поэтому ID событий совпадают между фидами, и связка линии с результатами — это простой поиск по ключу, а не нечёткое сопоставление.
Задержка: число, которое определяет ваш UX
Для live-score-продукта свежесть данных и есть продукт. Bet in Box доставляет изменения счёта с задержкой 1–3 секунды. Стройте поллинг вокруг того, на что смотрит пользователь: открытый матч обновляйте каждые несколько секунд, страницу лиги — каждые 15–30 секунд, всё остальное — по требованию. Такой паттерн держит объём запросов ровным, а видимые данные ощущаются мгновенными.
Паттерны интеграции по типам продуктов
- Портал live-результатов / аналог MyScore. Кешируйте матчи дня, опрашивайте live-матчи, рендерьте из собственного хранилища. Мы также поставляем это как платформу в стиле MyScore под ключ.
- Бот-уведомления. Опрашивайте live-состояние по расписанию, сравнивайте с предыдущим снимком и отправляйте сообщение при изменении — голы, начало матча, финальный свисток.
- Букмекерская платформа. Результаты запускают расчёт: когда матч получает статус завершённого, запросите детальный результат и рассчитайте открытые ставки — или вовсе пропустите эту логику и отправляйте купоны в API расчёта ставок, который возвращает выигрыш / проигрыш / возврат.
- Аналитика. Ежедневно собирайте результаты с детализацией по периодам в своё хранилище; сезон детальных данных — фундамент для моделей прогнозирования.
С чего начать
В документации есть примеры запросов с реальными JSON-ответами по каждому эндпоинту. Бесплатный триал даёт полный фид на неделю — достаточно, чтобы прогнать реальный игровой день через вашу интеграцию и измерить задержку самостоятельно.