MatchClub

Получение списка подписок пользователя

GET /v5/gid/user/subscriptions

Информация о подписках пользователя будет запрашиваться каждый раз при входе в личный кабинет Газпром ID

Важные моменты

Вызов метода будет доступен только от белых списков IP-адресов, которые заранее будут добавлены
При авторизации использовать API-ключ (API key)
Информация по подпискам:

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

Request parameters

user_gid_id

string required

Идентификатор пользователя в ГИД

Example:

YUjBxoReNPGvV5W7nAecKV

Request headers

X-API-Key

string required

API-ключ для получения данных

Example:

168e6a72c72b4886a73d40acf6429bf1

Responses

200 200

OK

Body

application/json

Object

result

Object

Подписки пользователя

user_gid_id

string

Идентификатор пользователя в ГИД

subscriptions

Array of UserSubsriptions

Список всех подписок пользователя

url_lk

string

Ссылка для перехода в ЛК пользователя на Матч ТВ

Example:

https://matchtv.ru/profile

404 404

Пользователь не найден

Body

application/json

Object

Error

401 Unauthorized

Неверный API-ключ (API key)

Body

Object

Error

Подписки пользователя

Несколько подписок в ответе

Неправильный идентификатор

У пользователя никогда не было и нет активных подписок

Невалидный ApiKey

GET /v5/gid/user/subscriptions?user_gid_id=YUjBxoReNPGvV5W7nAecKV HTTP/1.1 

X-API-Key: 168e6a72c72b4886a73d40acf6429bf1

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": {
        "user_gid_id": "YUjBxoReNPGvV5W7nAecKV",
        "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
            }
        ],
        "url_lk": "https://matchtv.ru/profile"
    }

GET /v5/gid/user/subscriptions?user_gid_id=YUjBxoReNPGvV5W7nAecQW HTTP/1.1 

X-API-Key: 168e6a72c72b4886a73d40acf6429bf1

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": {
        "user_gid_id": "YUjBxoReNPGvV5W7nAecQW",
        "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
            }
        ],
        "url_lk": "https://matchtv.ru/profile"
    }
}

GET /v5/gid/user/subscriptions?user_gid_id=1 HTTP/1.1 

X-API-Key: 168e6a72c72b4886a73d40acf6429bf1

HTTP/1.1 404 Not Found 

Content-Type: application/json

{
    "Error": {
        "error": {
            "code": "404",
            "message": "User is not found"
        }
    }
}

GET /v5/gid/user/subscriptions?user_gid_id=YUjBxoReNPGvV5W7nerttf HTTP/1.1 

X-API-Key: 168e6a72c72b4886a73d40acf6429bf1

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "result": {
        "user_gid_id": "YUjBxoReNPGvV5W7nerttf",
        "subscriptions": [
            ],
        "url_lk": "https://matchtv.ru/profile"
    }
}

GET /v5/gid/user/subscriptions?user_gid_id=YUjBxoReNPGvV5W7nAecKV HTTP/1.1 

X-API-Key: 01

HTTP/1.1 401 Unauthorized 

Content-Type: application/json

{
    "Error": {
        "error": {
            "code": "401",
            "message": "Unauthorized request"
        }
    }
}

Object

subscription_name

string required

Название подписки

Example:

М! Максимум

subscription_logo

Object

Логотип подписки

url

string

Ссылка на логотип подписки

Example:

https://filebank.zxz.su/files/match-club/new_app/product/icon/78a0/9e74/78a09e742a8edfdbc6a230a762b39a1c.svg

width

integer

Ширина

Example:

20

height

integer

Высота

Example:

20

mimo

string

Формат

Example:

image/svg

is_active

boolean required

Статус подписки (Активна = true, Неактивна = false)

expired_at

string required

Дата истечения подписки

Example:

2025-06-20T23:59:59Z

is_recurring

boolean

Признак автопродления

Example:

true

Object

error

Object

code

string

Код ошибки

Example:

404

message

string

Текст ошибки

Example:

User is not found