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