Початок роботи¶
Цей урок проводить через перші підписані запити. Після нього ви знатимете, що ваші ключі та 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).
Крок 6. Увійдіть у MEGOGO¶
- Відкрийте застосунок 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 · Повідомити про проблему на цій сторінці