Начало работы¶

Этот урок проводит через первые подписанные запросы. После него вы будете знать, что ваши ключи и IP-адреса работают, а код правильно вычисляет подпись.

Время: около 20 минут.

Перед началом¶

Вам понадобятся:

Тестовые учетные данные: ID партнера, публичный и приватный ключи, тестовые ID услуг. См. Учетные данные.
Сервер с IP-адресом, который MEGOGO добавил в список вашего тестового ID партнера.
Тестовая SIM-карта — нужен ее номер телефона.
Python 3 на сервере. В примерах используется код со страницы Подпись запроса.

ВНИМАНИЕ

Тестовый ID партнера работает на рабочих серверах. Используйте только номер своей тестовой SIM-карты.

Шаг 1. Вычислите подпись¶

Скопируйте функции terminals_sign и signed_url со страницы Подпись запроса и запустите рабочий пример. Результат должен совпасть с URL из шага 6 рабочего примера.

Шаг 2. Получите свои услуги¶

Отправьте subscriptions без номера телефона:

print(signed_url("/terminals/{partner_id}/subscriptions", {},
                 "{private_key}", "{public_key}"))

curl "https://billing.megogo.net/terminals/{partner_id}/subscriptions?sign={sign}"

Ожидаемый ответ (сокращенно):

[
  {
    "serviceId": "example_light_30d",
    "serviceName": "Light (partner)",
    "serviceDescription": "TV channels and a movie collection",
    "tariff": {"tariffId": 12345, "tariffName": "30 days", "price": 0, "tryAndBuy": false},
    "dateFinish": -1,
    "dateFinishString": "1969-12-31 23:59:59"
  }
]

В списке — услуги, которые MEGOGO настроил для вашего ID партнера. Найдите свои тестовые ID услуг в поле serviceId.
Если ID услуги, полученного от менеджера, в списке нет, сообщите своему менеджеру MEGOGO.

Если получаете HTTP 401, см. Решение проблем.

Шаг 3. Проверьте тестовый номер телефона¶

curl "https://billing.megogo.net/terminals/{partner_id}/user/phone?phone={phone}&sign={sign}"

Ответ	Значение
`{"successful": true}`	В MEGOGO есть пользователь с этим номером телефона
`{"successful": false, "message": "User doesn't not exist"}`	Номер телефона не зарегистрирован в MEGOGO. Текст приведен так, как его возвращает API

Шаг 4. Подключите тестовую подписку¶

Отправьте subscribe со своим тестовым номером и тестовым ID услуги:

curl "https://billing.megogo.net/terminals/{partner_id}/subscription/subscribe?phone={phone}&serviceId={service_id}&sign={sign}"

Ожидаемый ответ:

{"successful": true}

Если номер не был зарегистрирован, MEGOGO создал пользователя.

Шаг 5. Проверьте подписку¶

curl "https://billing.megogo.net/terminals/{partner_id}/subscriptions?phone={phone}&sign={sign}"

В ответе — ваша услуга с датой окончания в dateFinish (Unix-время) и dateFinishString (UTC).

Откройте приложение MEGOGO или сайт MEGOGO.
Выберите вход по номеру телефона.
Введите тестовый номер и одноразовый код из SMS или Viber.
Убедитесь, что подписка есть в профиле, а видео из подписки воспроизводится.

Шаг 7. Отключите подписку¶

curl "https://billing.megogo.net/terminals/{partner_id}/subscription/unsubscribe?phone={phone}&serviceId={service_id}&sign={sign}"

Ожидаемый ответ: {"successful": true}. Повторите шаг 5 — ответ будет [].

Что дальше¶

Жизненный цикл подписки: режимы продления и состояния подписки.
Подключение подписки для ваших пользователей.
Продление, приостановка и отключение.

Версия руководства 1.0.0, 2026-11-02 · Сообщить о проблеме на этой странице