Последние обновления Sport Line API

Здесь собраны изменения, которые влияют на интеграцию: новые методы и параметры, изменения ответов и ошибок. Новые записи — сверху.

6 октября 2026

Новый метод topchampionships — популярные чемпионаты

• Было: готовых подборок было две, и обе — матчей (topmatches, toplist); список популярных чемпионатов приходилось собирать самостоятельно.
• Стало: GET /v1/topchampionships/{live|line}/{lang} возвращает до 12 популярных чемпионатов с видом спорта, страной и количеством матчей. Prematch — главные чемпионаты (Лига Чемпионов, топ-лиги, NBA и т. п.), Live — самые популярные из идущих сейчас.
• Подробнее: topchampionships.

Календарь матчей: все виды спорта, периоды по часам и дням

• Было: календарь линии (events по периоду) работал только для футбола, данные собирались отдельными запросами и могли отставать; метод не был описан в документации.
• Стало: календарь работает для всех видов спорта линии и строится из той же Prematch-линии, что и events. Периоды: ближайшие 2, 4, 6 или 12 часов, сегодня до конца суток или конкретный день до 5 дней вперёд. Поддерживается odds=false.
• Подробнее: Календарь матчей.

toplist — для всех видов спорта Prematch

• Было: toplist мог вернуть пустой список: по виду спорта, у которого в этот момент не было Live-матчей, и в течение некоторого времени после обновления сервиса. В подборку могли попасть служебные разделы.
• Стало: топ строится для всех видов спорта Prematch и доступен сразу после обновления сервиса; служебные разделы отфильтрованы, как в topmatches. Если у вида спорта нет топ-матчей, список по-прежнему пустой.
• Подробнее: toplist.

Ответы без коэффициентов — параметр odds=false

• Было: методы с матчами всегда возвращали коэффициенты (game_oc_list), даже если проекту нужны только расписание, счёт или статистика.
• Стало: необязательный параметр odds=false возвращает те же данные без game_oc_list. Ответ в 2–5 раз меньше, страница одного матча — в десятки раз. Поле game_oc_counter (сколько исходов у матча) остаётся. Работает в events (в том числе в календаре линии), event, а также в topmatches и toplist с full=true (короткие карточки этих методов коэффициентов и так не содержат). Без параметра ответ не меняется.
• Подробнее: Основные понятия — данные без коэффициентов, events, event.

4 октября 2026

Prematch вида спорта: по умолчанию «Топ-50», вся линия — match=all

• Было: запрос Prematch по всему виду спорта (tournamentId=0) возвращал всю линию — у футбола это около 2000 матчей и ~9 МБ JSON.
• Стало: по умолчанию возвращается «Топ» — 50 ближайших матчей с наибольшим весом популярности (топ-лиги и турниры). Вся линия — с параметром match=all; турниры в ней упорядочены по популярности, матчи — по времени начала. Запросы по конкретному турниру, Live и киберспорт не изменились.
• Подробнее: events.

Подсобытия больше не дублируют матчи в списках

• Было: подсобытия матча (например «Дуэль игроков (голы)») приходили в списке events отдельными строками и выглядели как дубли матчей.
• Стало: в списках — только основные матчи. Подсобытия доступны в sub_games основного матча и запрашиваются методом event по их game_id.
• Подробнее: events, дополнительные матчи и субматчи.

Новый метод account — ключи и доступ клиента

• Было: узнать срок действия ключа, доступные виды спорта и языки можно было только у менеджера.
• Стало: GET /v1/account по любому ключу клиента возвращает данные по всем его ключам: срок, сколько дней осталось, виды спорта и языки, ограничения доступа, время последнего запроса, число запросов за 7 дней и IP-адрес, с которого пришёл запрос.
• Подробнее: account.

Дата окончания ключа в каждом ответе — заголовок X-Key-Expires

• Было: дату окончания доступа нельзя было получить из ответа API.
• Стало: каждый успешный ответ содержит заголовок X-Key-Expires с датой окончания ключа (ISO 8601, UTC) — по нему можно заранее напомнить о продлении.
• Подробнее: Авторизация и доступ.

Новые ошибки ключа: пауза и «ещё не действует»

• Было: приостановленный ключ получал ту же ошибку, что и просроченный, — Package has expired; выдать ключ с датой начала в будущем было нельзя.
• Стало: приостановленный ключ получает Package is blocked (срок при этом не меняется); ключ можно выдать заранее, и до даты начала он получает Package is not active yet. Package has expired — только когда срок действительно истёк.
• Подробнее: Обработка ошибок.

Ключи с языком all и невключённый язык

• Было: ключ со всеми языками (all) на языке, который не включён в линии, получал матч без коэффициентов.
• Стало: такой запрос получает ошибку Invalid language — как и ключ с отдельным списком языков.
• Подробнее: Обработка ошибок, языки.

Ограничение доступа ключа по IP и сайтам

• Было: ключ работал с любого сервера и сайта.
• Стало: по запросу клиента ключ можно привязать к IP-адресам его серверов и (или) к его сайтам. С другого адреса API отвечает ошибкой Access from IP … is not allowed for this Package (или site …), в тексте — адрес, который нужно разрешить. Без привязки ключ работает как раньше.
• Подробнее: Авторизация и доступ, Обработка ошибок.

Новый ключ или продление начинают действовать сразу

• Было: после выдачи нового ключа или продления срока изменения могли вступать в силу с задержкой.
• Стало: новый ключ, продление, пауза и возобновление действуют сразу.

Служебные турниры не попадают в линию

• Было: в меню и списках встречались служебные разделы букмекера («Специальные ставки», «Победитель», «Итоги», «Альтернативные» и подобные).
• Стало: такие разделы не попадают в меню, турниры, списки матчей, топ и поиск.

Названия исходов — как у букмекера

• Было: часть названий исходов приходила с незаполненными шаблонами и служебными скобками.
• Стало: названия исходов формируются по правилам букмекера; исходы неизвестного формата не показываются. В видах спорта, где исходы — имена участников (Формула-1, скачки и др.), названия приходят на языке запроса.
• Подробнее: коэффициенты и группы ставок.