MatchClub
{user_id}
/subscriptions{user_id}
/subscriptionsAuthentication
Информация о подписках пользователя будет запрашиваться каждый раз при входе в личный кабинет Газпром ID
Важные моменты
- Вызов метода будет доступен только от белых списков IP-адресов, которые заранее будут добавлены
- При авторизации использовать API-ключ (API key)
- Информация по подпискам:
- в случае если были куплены подписки в разные периоды без автопродления, то отдаются данные по подписке на позднюю дату,
- ответ включает в себя и подписки по архивным продуктам
Path variables
Идентификатор пользователя в ГИД
Request headers
API-ключ для получения данных
Responses
OK
Body
Идентификатор пользователя
Ссылка для перехода в ЛК пользователя на Матч ТВ
Пользователь не найден
Body
Неверный API-ключ (API key)
Body
GET /v5/gid/user/YUjBxoReNPGvV5W7nAecKV/subscriptions HTTP/1.1
X-API-Key: 168e6a72c72b4886a73d40acf6429bf1
HTTP/1.1 200 OK
Content-Type: application/json
{
"user_gid_id": "YUjBxoReNPGvV5W7nAecKV",
"url_lk": "https://matchtv.ru/profile"
"subscriptions": [
{
"subscription_name": "М! Максимум",
"subscription_logo": {
"url": "https://filebank.zxz.su/files/match-club/new_app/product/icon/78a0/9e74/78a09e742a8edfdbc6a230a762b39a1c.svg",
"width": 20,
"height": 20,
"mimo": "image/svg"
},
"is_active": true,
"expired_at": "2025-06-20T23:59:59Z",
"is_recurring": true
}
]
}
GET /v5/gid/user/YUjBxoReNPGvV5W7nAecQW/subscriptions HTTP/1.1
X-API-Key: 168e6a72c72b4886a73d40acf6429bf1
HTTP/1.1 200 OK
Content-Type: application/json
{
"user_gid_id": "YUjBxoReNPGvV5W7nAecQW",
"url_lk": "https://matchtv.ru/profile"
"subscriptions": [
{
"subscription_name": "М! Максимум",
"subscription_logo": {
"url": "https://filebank.zxz.su/files/match-club/new_app/product/icon/78a0/9e74/78a09e742a8edfdbc6a230a762b39a1c.svg",
"width": 20,
"height": 20,
"mimo": "image/svg"
},
"is_active": true,
"expired_at": "2025-06-20T23:59:59Z",
"is_recurring": true
},
{
"subscription_name": "М! Премьер",
"subscription_logo": {
"url": "https://api-dev-410.match-club.ru/files/match-club/new_app/product/icon/ce8d/000b/ce8d000b0d07b2f434fcdf02611500e2.svg",
"width": 20,
"height": 20,
"mimo": "image/svg"
},
"is_active": false,
"expired_at": "2024-01-20T23:59:59Z",
"is_recurring": false
}
]
}
GET /v5/gid/user/1/subscriptions HTTP/1.1
X-API-Key: 1222e6a72c7212344a73d40acf6429bf1
HTTP/1.1 404 Not Found
Content-Type: application/json
{
"server_time": "2025-07-23T10:47:31Z",
"error": {
"code": 404,
"title": "Ошибка",
"message": "User is not found"
}
}
GET /v5/gid/user/YUjBxoReNPGvV5W7nerttf/subscriptions HTTP/1.1
X-API-Key: 168e6a72c72b4886a73d40acf6429bf1
HTTP/1.1 200 OK
Content-Type: application/json
{
"user_gid_id": "YUjBxoReNPGvV5W7nerttf",,
"url_lk": "https://matchtv.ru/profile"
"subscriptions": [
]
}
GET /v5/gid/user/YUjBxoReNP1vV5W7nAecKV/subscriptions HTTP/1.1
X-API-Key: 001
HTTP/1.1 401 Unauthorized
Content-Type: application/json
{
"server_time": "2025-07-23T10:47:31Z",
"error": {
"code": 401,
"title": "Ошибка",
"message": "Unauthorized request"
}
}
Название подписки
Логотип подписки
Ссылка на логотип подписки
Ширина
Высота
Формат
Статус подписки (Активна = true, Неактивна = false)
Дата истечения подписки
Признак автопродления
{id}
/data{id}
/dataAuthentication
Path variables
Идентификатор коллекции
Request parameters
Максимальное количество элементов списка, которое будет отдано в ответе
Постраничная навигация (Отступ от начала списка)
Responses
Body
Идентификатор коллекции
Наименование коллекции
Признак - есть ли в наличии еще контент для коллекции больше указанного значения в параметре limit
Список контентов в коллекции
Неверный идентификатор коллекции
Body
GET /v5/shelves/collection/5/data?limit=2 HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 5,
"name": "Обзоры всех туров",
"has_more": true,
"items": [
{
"type": "ppv",
"data": {
"id": 45,
"title": "Зенит - Химки",
"subtitle": "МИР Российская Премьер-Лига. Тур 1",
"is_paid": true,
"has_multicam": true,
"has4k": true,
"has_audio": true,
"has_stat": true,
"has_moments": true,
"product_ids": [
16
],
"image": {
"url": "https://cdn-sportbox.zxz.su/images/styles/upload/fp_fotos/47/dd/ea507573ba1b7bfea6bbd715e4aa4c10686e2c4c85bae538300555.jpg",
"width": 20,
"height": 20,
"mime": "png"
},
"background": {
"url": "https://cdn-sportbox.zxz.su/images/styles/upload/fp_fotos/47/dd/ea507573ba1b7bfea6bbd715e4aa4c10686e2c4c85bae538300555.jpg",
"width": 20,
"height": 20,
"mime": "png"
},
"state": "archive",
"pg": "6+",
"dt_start": "2025-06-20T11:55:32Z",
"dt_finish": "2025-06-20T12:55:32Z"
},
"view_sec": 100
},
{
"type": "ppv",
"data": {
"id": 43,
"title": "Оренбург - Челябинск",
"subtitle": "Лига PARI. Тур 1",
"is_paid": false,
"has_multicam": false,
"has4k": false,
"has_audio": false,
"has_stat": false,
"has_moments": false,
"image": {
"url": "https://cdn-sportbox.zxz.su/images/styles/upload/fp_fotos/47/dd/ea507573ba1b7bfea6bbd715e4aa4c10686e2c4c85bae538300555.jpg",
"width": 20,
"height": 20,
"mime": "png"
},
"state": "archive",
"pg": "6+",
"dt_start": "2025-07-01T19:01:32Z",
"dt_finish": "2025-07-01T20:55:32Z"
},
"view_sec": 100
}
]
}
GET /v5/shelves/collection/999999999999999/data HTTP/1.1
HTTP/1.1 404 Not Found
Content-Type: application/json
{
"error": {
"code": "404",
"title": "Ошибка",
"message": "Коллекция не найдена"
}
}
Элемент видеоконтента в коллекции
Тип контента
Трансляция
Видео
Данные для отображения карточки контента
Идентификатор контента
Наименование контента
Для трансляций выводится “Основной заголовок” (basic_title), если отсутствует, то “Заголовок” (title)
Описание контента
Для трансляций выводится “Подзаголовок” second_title, если отсутствует, то “Описание” (subtitle), если отсутствует и subtitle, то ничего не выводим
Признак платности контента
Признак мультикама
Признак 4к
Признак наличия аудиодорожек
Признак отображения статистики
Признак наличия моментов
Идентификаторы продуктов, в которые входят трансляция/видео по подписке Передается, если контент доступен только по подписке
Карточка контента
Фоновая картинка
Статус трансляции
Возрастное ограничение
Дата начала трансляции
Дата окончания трансляции
Продолжительность (только для видео)
Дата публикации
Время показа в секундах (для ручного добавленного контента)
Данные по изображению
Данные по изображению
Ссылка на картинку
Ширина
Высота
Формат картинки