Последние обновления Sport Line API
Здесь собраны изменения, которые влияют на интеграцию: новые методы и параметры, изменения ответов и ошибок. Новые записи — сверху.
10 октября 2026
Ошибки ключа и языка, Game not found — с HTTP-статусом
- Было: ошибки API-ключа и языка (
Missing Package header,Invalid Package,Package has expired,Package is blocked,Access denied,Invalid languageи др.) приходили с HTTP-статусом 200 — отличить их можно было только по телу ответа. - Стало:
401— ключ не передан или не найден;403— ключ истёк, приостановлен, ещё не начал действовать, запрос с неразрешённого IP или сайта, нет доступа к виду спорта или языку;400— неподдерживаемый язык. Тело ошибки прежнее:error_codeиerror_message.eventсGame not found—404, тело прежнее (body.message).Game id finishedпо-прежнему приходит с200. - Что сделать: если HTTP-клиент на статусах 4xx выбрасывает исключение, читайте тело ответа и в этом случае;
404 от
eventсbody.message— этоGame not found(примеры кода обновлены). Если интеграция рассчитана только на 200 — обратитесь к менеджеру SportAPI. - Подробнее: Обработка ошибок.
Проверка параметров, лимит запросов, понятные ответы при недоступности источника
- Было: неверные значения в адресе (тип линии, формат) давали пустой ответ; поиск принимал текст из одной буквы;
лимита запросов не было; при сбое источника
searchиeventмогли вернуть пустой ответ без пояснения. - Стало: неверные значения в адресе — ошибка
Invalid request(HTTP 400) с объяснением; поиск — от 2 символов, одинаковый запрос минуту отдаётся из кэша; ключ — до 50 запросов в секунду в среднем (всплеском до 100), сверх —Too many requests(HTTP 429) с заголовкомRetry-After; при недоступности источника —Temporarily unavailable, try again later(HTTP 503 с заголовкомRetry-After, уsearchиevent). - Подробнее: Обработка ошибок,
search.
9 октября 2026
event проверяет вид спорта тарифа
- Было: метод
eventпоgame_idотдавал матч любого вида спорта, даже не входящего в тариф ключа. - Стало: матч вида спорта вне тарифа не отдаётся — ошибка
Access denied(HTTP 403), как уeventsдля чужогоsportId. На неизвестные адреса API тоже отвечаетAccess deniedс HTTP 403. - Подробнее: Обработка ошибок.
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, скачки и др.), названия приходят на языке запроса.
- Подробнее: коэффициенты и группы ставок.