Колекція Postman¶
Колекція Postman містить усі запити цього посібника. Скрипт колекції сам підписує кожен запит, тож запити можна спробувати зі своїми тестовими обліковими даними.
Імпорт колекції¶
- У Postman оберіть Import і виберіть файл
megogo-terminals.postman_collection.json. - Створіть середовище (environment), наприклад «MEGOGO test».
- Додайте в середовище змінні з таблиці нижче.
- Виберіть це середовище.
| Змінна | Значення |
|---|---|
partner_id |
Ваш тестовий ID партнера |
public_key |
Ваш публічний ключ |
private_key |
Ваш приватний ключ. Тип: secret |
phone |
Номер телефону вашої тестової SIM-картки: лише цифри, міжнародний формат, без + |
service_id |
ID послуги тестової передплати |
УВАГА
Не зберігайте приватний ключ у колекції. Не передавайте й не експортуйте середовище, у якому він є.
ОБЕРЕЖНО
Записуйте номер без +. Postman не кодує + в URL, і сервер читає
його як пробіл: запит отримує HTTP 401.
Надсилання запитів¶
Надсилайте запити з комп'ютера, IP-адреса якого є у вашому списку. Див. Облікові дані.
- Надішліть Your services. Очікуваний результат: список, у якому є
ваш
service_id. - Надішліть Check the phone number. У консолі Postman видно, чи зареєстрований номер.
- Надішліть Subscribe. Очікуваний результат:
"successful": true. - Надішліть User services. У списку — ваша послуга з датою закінчення.
- Надішліть Unsubscribe, потім ще раз User services: результат
[].
Кожен запит має тест, що перевіряє результат.
УВАГА
Subscribe і User services створюють користувача MEGOGO, якщо номер не зареєстрований. Використовуйте лише номер своєї тестової SIM-картки.
У колекції є також Suspend і Resume. Надсилайте Resume лише після Suspend. Див. Продовження, призупинення й відключення.
Змінні¶
| Змінна | За замовчуванням | Опис |
|---|---|---|
terminals_api |
https://billing.megogo.net |
Базовий URL API |
Як скрипт підписує запит¶
Перед кожним запитом скрипт:
- Видаляє
signз URL. - Записує приватний ключ,
GETі шлях, підставивши значення змінних. - Дописує всі ввімкнені query-параметри, відсортовані за назвою, у
вигляді
назва=значення. - Обчислює хеш SHA-256, кодує шістнадцятковий текст у Base64, видаляє
=, замінює/і+на-і дописує_та публічний ключ. - Додає
signдо URL.
Якщо ви додасте до запиту параметр, скрипт включить його в підпис. Див. Підпис запиту.
Версія посібника 1.3.0, 2026-11-02 · Повідомити про проблему на цій сторінці