Match

1. Методы для интеграции с ГИД
GET /v5/gid/user/subscriptions/access_token={access_token}
Получение списка подписок пользователя
GET /v5/gid/user/subscriptions/access_token={access_token}

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

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

  1. Вызов метода будет доступен только от белых списков IP-адресов, которые заранее будут добавлены
  2. Access-токен статичен
  3. Информация по подпискам:
  • в случае если были куплены подписки в разные периоды без автопродления, то отдаются данные по подписке на позднюю дату,
  • ответ включает в себя и подписки по архивным продуктам

Path variables

access_token
string required

Токен

Example:
168e6a72c72b4886a73d40acf6429bf1

Request parameters

user_gid_id
string required

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

Example:
YUjBxoReNPGvV5W7nAecKV

Responses

200 200

OK

Body
application/json
Object
result
Object

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

user_gid_id
string

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

subscriptions

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

url_lk
string

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

Example:
https://matchtv.ru/profile
404 404

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

Body
application/json
Object
Error
401 Unauthorized

Не найден токен или он невалидный

Body
Object
Error
Подписки пользователя
Несколько подписок в ответе
Неправильный идентификатор
У пользователя никогда не было и нет активных подписок
Не найден токен или он невалидный
GET /v5/gid/user/subscriptions/access_token=168e6a72c72b4886a73d40acf6429bf7?user_gid_id=YUjBxoReNPGvV5W7nAecKV HTTP/1.1 

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/access_token=168e6a72c72b4886a73d40acf6429bf7?user_gid_id=YUjBxoReNPGvV5W7nAecQW HTTP/1.1 

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/access_token=168e6a72c72b4886a73d40acf6429bf7?user_gid_id=1 HTTP/1.1 

HTTP/1.1 404 Not Found 

Content-Type: application/json

{
    "Error": {
        "error": {
            "code": "404",
            "message": "User is not found"
        }
    }
}
GET /v5/gid/user/subscriptions/access_token=168e6a72c72b4886a73d40acf6429bf7?user_gid_id=YUjBxoReNPGvV5W7nerttf HTTP/1.1 

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/access_token=1123?user_gid_id=YUjBxoReNPGvV5W7nAecKV HTTP/1.1 

HTTP/1.1 401 Unauthorized 

Content-Type: application/json

{
    "Error": {
        "error": {
            "code": "401",
            "message": "Not authorized"
        }
    }
}
UserSubsriptions
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
Error
Object
error
Object
code
string

Код ошибки

Example:
404
message
string

Текст ошибки

Example:
User is not found