Live 3D Tracker в Sport Line API

Что такое Live 3D Tracker

Live 3D Tracker — это готовый виджет визуализации спортивного матча. Он показывает поле или площадку, положение мяча, атаки, счёт, таймер и игровые события.

Sport Line API не передаёт клиенту данные для самостоятельной отрисовки трекера. API только помогает определить, доступен ли готовый виджет для конкретного матча, и возвращает его идентификатор в поле zp.

Sport Line API → поле zp → готовый виджет Live 3D Tracker

Трекер не является самостоятельным источником списка матчей. Чтобы найти матч и получить его zp, клиенту нужна подписка на спортивную линию SportAPI.

Готовый виджет

Клиенту не нужно разрабатывать визуализацию матча самостоятельно. SportAPI предоставляет готовый виджет, который встраивается на сайт или в веб-приложение.

Доступны два способа подключения:

прямой iframe;
скрипт embed.js, который автоматически создаёт iframe и позволяет управлять виджетом через JavaScript.

Краткий пример прямого встраивания:

<iframe
  src="https://bet-embed-sport-tracker.vercel.app/?key=pk_live_yourkey&gameid=745829876&sport=1&lang=ru"
  style="width: 100%; height: 360px; border: none; display: block;"
  allowfullscreen
  title="Live tracker"
></iframe>

Трекер предназначен только для встраивания. Его страницу не нужно открывать как самостоятельную страницу сайта.

Полная документация по подключению

Способы встраивания, получение ключа, разрешённые домены, параметры, смена матча и диагностика подробно описаны в полной документации Live 3D Tracker.

Демонстрация внешнего вида: https://bet-embed-sport-tracker-stage.vercel.app/showcase.

Демонстрационная страница не использует реальные Live-данные. Она показывает внешний вид виджета для поддерживаемых видов спорта.

Поле `zp`

Поле zp находится в объекте матча спортивной линии:

{
  "game_id": 746266481,
  "sport_id": 1,
  "zp": 746266481
}

Значение zp передаётся в параметр gameid готового виджета:

gameid трекера = zp спортивной линии

Для примера выше:

BetZoneEmbed.init({
  container: '#zone',
  key: 'pk_live_yourkey',
  gameid: 746266481,
  sport: 1,
  lang: 'ru',
  height: 360
});

Не передавайте в gameid поля game_id, game_mid или stat_id. Даже если в отдельном ответе game_id и zp имеют одинаковые числа, назначение у них разное.

Когда показывать трекер

Виджет можно показывать только при одновременном выполнении условий:

Матч находится в Live.
Вид спорта поддерживается трекером.
Поле zp содержит ID, а не null.
У клиента есть активный ключ Live 3D Tracker.
Домен страницы разрешён для этого ключа.
Вид спорта и язык входят в подключённый тариф.

Если спортивная линия возвращает:

{
  "zp": null
}

для этого матча трекер недоступен. Не создавайте пустой виджет и не подставляйте вместо zp другой идентификатор.

Поддерживаемые виды спорта

В параметре sport передаётся значение sport_id матча.

ID	Вид спорта
`1`	Футбол
`2`	Хоккей
`3`	Баскетбол
`4`	Теннис
`5`	Бейсбол
`6`	Волейбол
`7`	Регби
`8`	Гандбол
`10`	Настольный теннис
`13`	Американский футбол
`17`	Водное поло
`21`	Дартс
`26`	Формула-1
`28`	Австралийский футбол
`44`	Скачки
`66`	Крикет
`86`	CS:GO / киберспорт

Наличие вида спорта в таблице означает, что трекер умеет его отображать. Это не гарантирует наличие визуализации у каждого Live-матча. Окончательная проверка всегда выполняется по полю zp.

Доступный клиенту набор видов спорта может быть ограничен тарифом.

Практические правила интеграции

Показывайте трекер только для Live-матча.
Проверяйте, что sport_id входит в список поддерживаемых видов спорта.
Передавайте значение zp как gameid без изменения.
При zp: null не создавайте виджет.
Используйте готовый iframe или embed.js, а не собственную отрисовку данных.
Не смешивайте zp с game_id и другими идентификаторами.
Для полной интеграции используйте документацию Live 3D Tracker.

Поддержка

Для получения ключа и добавления рабочего, тестового домена или localhost обратитесь в поддержку SportAPI: @suport_sportapi.