MatchTV

Получение списка игр для Страницы Матч -центра

GET /api/v1/games/match-center

Authentication

Open

Данный метод используется для вывода данных

На Главной
На отдельной странице “Матч-центр”

Сортировка игр:

По турнирам
- учитывается настроенная сортировка видов спорта и турниров в Админке на странице Матч-Центра
Матчи внутри турнира
- по времени начала матча: от раннего к позднему
- статус (LIVE, завершен, отменен) на позицию не влияет

Request parameters

date

string optional

Фильтр для вывода матчей за определенную дату

Example:

20250623

Responses

200 OK

Body

Object

result

Array

Object

id

string required

Идентификатор вида спорта

Example:

SOCCER

title

string required

Название вида спорта (фильтр)

Example:

Футбол

championships

Array of championship

Группировка матчей по турнирам

Examples

{
    "result": [
        {
            "id": "SOCCER",
            "title": "Футбол",
            "championships": [
                {
                    "id": "383",
                    "name": "Вторая лига. Дивизион Б. Группа 1. Весна 2024",
                    "championshipTitle": "Мир Российская Премьер-Лига. Тур 1",
                    "icon": "https://s-cdn.sportbox.ru/sites/default/files/imagecache/card_icon_resize_140x140/stats_img/turnirs/logo/383_1702892139.png",
                    "seasonId": 135,
                    "tour": "Тур 1",
                    "championshipLink": "https://preprod.matchtv.zxz.su/football/rpl/calendar",
                    "eventType": 1,
                    "rates": {
                        "provider": "",
                        "ratesMarking": "Реклама. Рекламодатель: ООО \"Зеленоглазое такси\"",
                        "eventId": "1"
                    },
                    "events": [
                        {
                            "id": "f09c7480-d944-5a03-b0c6-332ac9bb3739",
                            "tourId": "1895082e-5d83-562c-92b0-67b5884059ec",
                            "tour": "Тур 2",
                            "startTime": "2025-06-23T01:00:00+03:00",
                            "eventLink": "https://sportbox.zxz.su/Vidy_sporta/Futbol/stats/turnir_23020/game_1380922537",
                            "broadcastLink": "https://news.sportbox.ru/Vidy_sporta/Futbol/Drugie/stats/turnir_18553/game_1380797238",
                            "eventState": "FUTURE",
                            "periodText": "",
                            "liveTime": {
                                "title": "60",
                                "isAddedTime": "true",
                                "isNumeric": "true"
                            },
                            "rates": {
                                "provider": "",
                                "ratesMarking": "Реклама. Рекламодатель: ООО \"Зеленоглазое такси\"",
                                "eventId": "1"
                            },
                            "homeParticipant": {
                                "id": "fb5d2eb7-be1d-56f5-8546-7885a15fb77b",
                                "name": "Зальцбург",
                                "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png",
                                "score": {
                                    "total": "",
                                    "extra": ""
                                },
                                "isWinner": true
                            },
                            "guestParticipant": {
                                "id": "fb5d2eb7-be1d-56f5-8546-7885a15fb77b",
                                "name": "Зальцбург",
                                "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png",
                                "score": {
                                    "total": "",
                                    "extra": ""
                                },
                                "isWinner": true
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

405 Method not allowed

Body

Object

error

errorMatchCenter

Examples

{
    "error": {
        "code": 405,
        "message": "Method not allowed, allow: SOME_METHOD, SOME_METHOD"
    }
}

400 Invalid request

Body

Object

error

errorMatchCenter

Examples

{
    "error": {
        "code": 400,
        "message": "\"some field\" must be something"
    }
}

200

GET /api/v1/games/match-center HTTP/1.1 

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": [
        {
            "id": "SOCCER",
            "title": "Футбол",
            "championships": [
                {
                    "id": "383",
                    "name": "Вторая лига. Дивизион Б. Группа 1. Весна 2024",
                    "championshipTitle": "Мир Российская Премьер-Лига. Тур 1",
                    "icon": "https://s-cdn.sportbox.ru/sites/default/files/imagecache/card_icon_resize_140x140/stats_img/turnirs/logo/383_1702892139.png",
                    "seasonId": 135,
                    "tour": "Тур 1",
                    "championshipLink": "https://preprod.matchtv.zxz.su/football/rpl/calendar",
                    "eventType": 1,
                    "rates": {
                        "provider": "",
                        "ratesMarking": "Реклама. Рекламодатель: ООО \"Зеленоглазое такси\"",
                        "eventId": "1"
                    },
                    "events": [
                        {
                            "id": "f09c7480-d944-5a03-b0c6-332ac9bb3739",
                            "tourId": "1895082e-5d83-562c-92b0-67b5884059ec",
                            "tour": "Тур 2",
                            "startTime": "2025-06-23T01:00:00+03:00",
                            "eventLink": "https://sportbox.zxz.su/Vidy_sporta/Futbol/stats/turnir_23020/game_1380922537",
                            "broadcastLink": "https://news.sportbox.ru/Vidy_sporta/Futbol/Drugie/stats/turnir_18553/game_1380797238",
                            "eventState": "FUTURE",
                            "periodText": "",
                            "liveTime": {
                                "title": "60",
                                "isAddedTime": "true",
                                "isNumeric": "true"
                            },
                            "rates": {
                                "provider": "",
                                "ratesMarking": "Реклама. Рекламодатель: ООО \"Зеленоглазое такси\"",
                                "eventId": "1"
                            },
                            "homeParticipant": {
                                "id": "fb5d2eb7-be1d-56f5-8546-7885a15fb77b",
                                "name": "Зальцбург",
                                "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png",
                                "score": {
                                    "total": "",
                                    "extra": ""
                                },
                                "isWinner": true
                            },
                            "guestParticipant": {
                                "id": "fb5d2eb7-be1d-56f5-8546-7885a15fb77b",
                                "name": "Зальцбург",
                                "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png",
                                "score": {
                                    "total": "",
                                    "extra": ""
                                },
                                "isWinner": true
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Список матчей в группировке по турниру

Формирование значения в поле “championshiptTitle” - Заголовок турнира для новой страницы Матч-Центра

Футбол
- для турниров со стадиями — стадия, тур
- для чемпионатов — тур
Хоккей
- для регулярных чемпионатов – обозначение регулярного чемпионата (стадия)
- для плей-офф — обозначение плей-офф и стадии
- для турниров со стадиями и турами — обозначение стадии и тура

Формирование значения в поле “championshipLink”

Ссылку для перехода на новую страницу турнира на beta на вкладку Календаря /football/rpl/calendar, если у турнира есть страница в Матч ТВ + учесть настройки турнира по отображению вкладок

Если у турнира активен таб “Календарь”
Если у турнира неактивен таб “Календарь”, то на Главную
Если у турнира нет страницы на Матч ТВ, то как уже реализовано ссылка на страницу Спортбокса

Object

id

string required

Идентификатор турнира

Example:

383

name

string

Составное название (Используется для вывода на Главной)

Example:

Вторая лига. Дивизион Б. Группа 1. Весна 2024

championshipTitle

string required

Формировуемое наименование турнира (Используется на странице Матч-Центра)

Example:

Мир Российская Премьер-Лига. Тур 1

icon

string

Логотип турнира

Example:

https://s-cdn.sportbox.ru/sites/default/files/imagecache/card_icon_resize_140x140/stats_img/turnirs/logo/383_1702892139.png

seasonId

integer required

Идентификатор сезона (Если завершен, то последнего)

Example:

135

tour

string

Название тура

Example:

Тур 1

championshipLink

string

Ссылка на страницу турнира вкладка Календарь

Example:

https://preprod.matchtv.zxz.su/football/rpl/calendar

eventType

integer

Тип (1 - TeamVsTeam: для игр по типу футбола, хоккея и т.п)

Example:

1

rates

Информация по рекламе

events

Array of event

Список матчей турнира

Информация об игре

Object

id

string

Идентификатор события в спортивной статистике

Example:

f09c7480-d944-5a03-b0c6-332ac9bb3739

tourId

string

Идентификатор тура

Example:

1895082e-5d83-562c-92b0-67b5884059ec

tour

string

Название тура

Example:

Тур 2

startTime

string

Дата и время начала

Example:

2025-06-23T01:00:00+03:00

eventLink

string

Ссылка на страницу события

Example:

https://sportbox.zxz.su/Vidy_sporta/Futbol/stats/turnir_23020/game_1380922537

broadcastLink

string

Ссылка на страницу трансляции события

Example:

https://news.sportbox.ru/Vidy_sporta/Futbol/Drugie/stats/turnir_18553/game_1380797238

eventState

string

Текущий статус-состояние события

Example:

FUTURE

periodText

string

null - если игра завершилась в основное время ДВ, ОТ, П, Б - если игра завершилась не в основное время

liveTime

Информация по текущему времени игры

rates

Информация о рекламе

homeParticipant

Информация о команде хозяев

Example:

{
    "id": "fb5d2eb7-be1d-56f5-8546-7885a15fb77b",
    "name": "Зальцбург",
    "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png",
    "score": {
        "total": "",
        "extra": ""
    },
    "isWinner": true
}

guestParticipant

Информация о команде гостей

Example:

{
    "id": "4650ef50-fd0b-5f14-9b58-0c5c1eed74e2",
    "name": "Аль-Хиляль",
    "icon": "https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1358253392_1674043570.png",
    "score": {
        "total": "",
        "extra": ""
    },
    "isWinner": true
}

Информация о лайф времени игры

Object

Информация о лайф времени

title

string

Название периода

Example:

60

isAddedTime

boolean

Идет дополнительное время

Example:

true

isNumeric

boolean

Является численным значением

Example:

true

Информация о рекламе

Object

Информация о рекламе

provider

string

Код букмекера

ratesMarking

string

Маркировка букмекера

Example:

Реклама. Рекламодатель: ООО "Зеленоглазое такси"

eventId

string

Идентификатор события у букмекера

Example:

1

Информация о команде гостей

Team

Информация о команде гостей

Информация о команде хозяев

Team

Информация о команде хозяев

Информация о команде игры

Object

id

string

Идентификатор команды

Example:

fb5d2eb7-be1d-56f5-8546-7885a15fb77b

name

string

Название команды

Example:

Зальцбург

icon

string

Логотип команды

Example:

https://s-cdn.sportbox.ru/sites/default/files/stats_img/club/fb/1220942989_1534844069.png

score

Object

Счет

total

string

Результат основной

extra

string

Результат дополнительный

isWinner

boolean

Признак победителя игры

Example:

true

Ошибка

Object

code

integer

Код ошибки

Example:

405

message

string

Текст ошибки

Example:

Method not allowed, allow: SOME_METHOD, SOME_METHOD

Возвращает список трансляций

GET /api/v1/broadcasts

Метод, который возвращает список трансляций для отображения на странице трансляций

Требования по отдаче данных:

1. Фильтры

Выборка трансляций осуществляется по фильтрам (рубрикам), настроенным в Админке в разделе для администрирования фильтров на странице трансляций
Отдавать данные с учетом настроенного порядка

3. Список дат

Отображается список дат в указанном диапазоне в параметрах

Если в параметрах не указано значения для фильтрации периода, то возвращается интервал с понедельника текущкй недели до воскресения (то есть информация за текущую неделю)
Если указана только дата начала, то указанная дата + 7 дней
Если указана только дата окончания, то от текущего дня до указанной даты
Если в дате нет трансляций, то возвращается для даты пустой массив items

3. Вывод списка турниров

Выводятся турниры, которые попадают под фильтры - указана рубрика у турнира И имеют трансляции в выбранный день

4. Сортировка вывода турниров

Турниры выводятся отсортированные по виду спорта (рубрике) и дате начала трансляции - выше тот турнир, у которого раньше начинается трансляция
Вид спорта сортируются также по времени начала первого события (дата начала трансляции) - выше тот вид спорта, у которого раньше начинается трансляция

5. Признак определения наличия трансляций на следующей недели

Поле “hasBroadcastsNextWeek” - Есть ли трансляции в следующей недели от последней даты результата
Для чего? - Для определения отображения “Стрелка вправо” в календаре

hasBroadcastsNextWeek = true, трансляции есть на следуюшей недели, то стрелка отображается
hasBroadcastsNextWeek = false, трансляции нет, то стрелка не отображается

Request parameters

date

integer optional

Для фильтрации периода, за который отображается список трансляций

По дефолту: текущий день

Example:

20250625

dateEnd

integer optional

Для фильтрации периода, за который отображается список трансляций

По дефолту: текущий день + 7 дней

Example:

20250626

termIds

array of integer optional

Идентификаторы рубрик (Для фильтрации по фильтрам)

Collection format: csv

offset

integer optional

Постраничная навигация

Responses

200 OK

Body

Object

result

Object

dates

Array

Список дат

Object

date

string required

Дата выборки

filers

Array of string

Список доступных фильтров за текущий день То есть по данному виду спорта есть трансляции за текущий день

Example:

Футбол, Хоккей

items

Array

Список трансляций за текущий день, сгруппированные по рубрике-виду спорта (фильтру) и по турнирам

Object

filter

Информация по рубрике - виду спорта (фильтру)

tournaments

Array of tournament

Список турниров

hasBroadcastsNextWeek

boolean

Есть ли трансляции в следующей недели от последней даты

Example:

true

400 Invalid request

Ошибка

Body

Object

error

200

400

Список трансляций за дату 25-06-2025

GET /api/v1/broadcasts HTTP/1.1 

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": {
        "dates": [
            {
                "date": "2025-06-25",
                "filers": [
                    "Футбол"
                ],
                "items": [
                    {
                        "filter": {
                            "id": "SOCCER",
                            "name": "Футбол"
                        },
                        "tournaments": [
                            {
                                "id": "18553",
                                "title": "Российская Премьер 1",
                                "subtitle": "Футбол",
                                "url": "https://beta.matchtv.ru/video/tournament/rpl",
                                "broadcasts": [
                                    {
                                        "id": 1,
                                        "title": "Химки - Локомотив",
                                        "subtitle": "Мир РПЛ. 12 тур",
                                        "imageUrl": "https://s-cdn.sportbox.ru/images/styles/1200-auto/fp_fotos/2c/f9/add883becc5b9d7a44208a28078c9d716609c8c2c7871643089136.jpg",
                                        "state": "FUTURE",
                                        "url": "FONBET Кубок России по футболу сезона 2023 - 2024 гг. 1/4 финала. Химки - Ростов",
                                        "startAt": "2020-07-22T19:00:00+03:00",
                                        "is4k": false,
                                        "isMulticam": false,
                                        "ageRating": "",
                                        "duration": 1,
                                        "productIds": [
                                            1
                                        ]
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        ],
        "hasBroadcastsNextWeek": true
    }
}

Проблема при запросе

GET /api/v1/broadcasts HTTP/1.1 

HTTP/1.1 400 Bad Request 

Content-Type: application/json

{
    "error": {
        "code": 400,
        "message": "\\\"some field\\\" must be something"
    }
}

Информация о фильтре

Object

id

string

Идентификатор фильтра

Example:

SOCCER

name

string

Название фильтра

Example:

Футбол

Информация о турнире

1. Формирование значения в поле "title"

Состоит из двух элементов, через запятую:

название турнира
обозначение этапа (если есть) и тур

Футбол

для турниров со стадиями - стадия для чемпионатов
для чемпионатов — тур

Хоккей

для регулярных чемпионатов – обозначение регулярного чемпионата - (стадия)
для плей-офф — обозначение плей-офф и стадии
для турниров со стадиями и турами — обозначение стадии и тура

2. Сортировка трансляций

По дате начала трансляций

Object

id

string required

Идентификатор турнира

Example:

18553

title

string required

Составное название турнира

Example:

Российская Премьер 1

subtitle

string

Рубрика вида спорта турнира

Example:

Футбол

url

string

Ссылка на страницу турнира в Видеохабе

Example:

https://beta.matchtv.ru/video/tournament/rpl

broadcasts

Array of broadcast

Список трансляций по турниру

Информация по трансляции

Object

id

integer required

Идентификатор трансляции

Example:

1

title

string required

Заголовок трансляции

Example:

Химки - Локомотив

subtitle

string

Подзаголовок трансляции

Example:

Мир РПЛ. 12 тур

imageUrl

string

Ссылка на картинку трансляции

Example:

https://s-cdn.sportbox.ru/images/styles/1200-auto/fp_fotos/2c/f9/add883becc5b9d7a44208a28078c9d716609c8c2c7871643089136.jpg

state

string

Статус трансляции

Enumeration:

FUTURE

Будущая

LIVE

В прямом эфире

ARCHIV

Завершенная

url

string

Ссылка на трансляцию

Example:

FONBET Кубок России по футболу сезона 2023 - 2024 гг. 1/4 финала. Химки - Ростов

startAt

string required

Дата начала трансляции

Example:

2020-07-22T19:00:00+03:00

is4k

boolean

Признак качества 4к

Example:

false

isMulticam

boolean

Признак мультикама

Example:

false

ageRating

string

Возрастной рейтинг (передается только для завершенных трансляций)

duration

integer

Длительность (передается только для завершенных трансляций)

productIds

Array of integer

Идентификаторы продуктов, в которые входит трансляция по подписке Передается, если контент платный, доступен только по подписке

currentTransmissionProgress

integer

Прогресс для лайв -трансляции (от 0 до 100)

Ошибка

Object

code

integer

Код ошибки

Example:

400

message

string

Текст ошибки

Example:

\"some field\" must be something

Возвращает доступные табы таблицы

GET /api/v1/seasons/{seasonId}/tables/tabs

Метод, который возвращает доступные вкладки для раздела “Таблица” страницы сезона турнира

Path variables

seasonId

string required

Идентификатор сезона

Responses

200 OK

Body

Object

result

Array of tab

Список доступных табов для отображения на вкладке

404 404

Не найден сезон по идентификатору

Body

Object

error

errorSeason

200

404

GET /api/v1/seasons/152/tables/tabs HTTP/1.1 

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": [
        {
            "type": "GROUP",
            "name": "Групповой турнир",
            "isCurrent": false
        },
        {
            "type": "PLAYOFF",
            "name": "Плей-офф",
            "isCurrent": true
        }
    ]
}

GET /api/v1/seasons/9999999999/tables/tabs HTTP/1.1 

HTTP/1.1 404 Not Found 

Content-Type: application/json

{
    "error": {
        "code": 404,
        "message": "Some entity with id [9999999999] not found"
    }
}

Информация о табе

Доступные виды табов:

Общий
Групповой
Конференции
Дивизионы
Плей-офф

Если таб один (вывод общей таблицы), то название вкладки не должно приходить (пример для РПЛ)

Object

type

string required

Тип

Enumeration:

ROUND_ROBIN

GROUP

CONFERENCE

для вида спорта = Хоккей

PLAYOFF

name

string

Название вкладки

Enumeration:

null

Без названия таба, когда только одна общая таблица

Групповой турнир

Конференции

для вида спорта = Хоккей

Дивизионы

для вида спорта = Хоккей

Плей-офф

isCurrent

boolean

Признак о том, что в текущий момент идет данная фаза игры

Example:

false

Ошибка

Object

code

integer

Код ошибки

Example:

404

message

string

Текст ошибки

Example:

Some entity with id [{id}] not found