External

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

GET /v5/gid/user/{user_id}/subscriptions

Authentication

Open

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

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

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

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

Path variables

user_id

string required

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

Example:

YUjBxoReNP1vV5W7nAecKV

Request headers

X-API-Key

string required

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

Example:

1222e6a72c7212344a73d40acf6429bf1

Responses

200 200

OK

Body

Object

user_gid_id

string

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

Example:

YUjBxoReNPGvV5W7nAec11

url_lk

string

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

Example:

https://matchtv.ru/profile

subscriptions

Array of UserSubsriptions

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

404 404

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

Body

Error

401 Unauthorized

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

Body

Error

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

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

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

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

Невалидный ApiKey

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 foundd"
    }
}

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: 0001

HTTP/1.1 401 Unauthorized 

Content-Type: application/json

{
    "server_time": "2025-07-23T10:47:31Z",
    "error": {
        "code": 401,
        "title": "Ошибка",
        "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

Example:

{
  "server_time": "2025-07-23T10:47:31Z",
  "error": {
    "code": 403,
    "title": "Ошибка",
    "message": "Access denied"
  }
}

server_time

string

Текущее время сервера в UTC

Example:

2025-07-23T10:47:31Z

error

Object

Ошибка

code

integer

Код ошибки

Example:

403

title

string nullable

Название

Example:

Ошибка

message

string

Сообщение

Example:

Access denied