Перейти до змісту

Колекція Postman

Колекція Postman містить усі запити цього посібника. Скрипт колекції сам підписує кожен запит, тож запити можна спробувати зі своїми тестовими обліковими даними.

Завантажити колекцію

Імпорт колекції

  1. У Postman оберіть Import і виберіть файл megogo-terminals.postman_collection.json.
  2. Створіть середовище (environment), наприклад «MEGOGO test».
  3. Додайте в середовище змінні з таблиці нижче.
  4. Виберіть це середовище.
Змінна Значення
partner_id Ваш тестовий ID партнера
public_key Ваш публічний ключ
private_key Ваш приватний ключ. Тип: secret
phone Номер телефону вашої тестової SIM-картки: лише цифри, міжнародний формат, без +
service_id ID послуги тестової передплати

УВАГА

Не зберігайте приватний ключ у колекції. Не передавайте й не експортуйте середовище, у якому він є.

ОБЕРЕЖНО

Записуйте номер без +. Postman не кодує + в URL, і сервер читає його як пробіл: запит отримує HTTP 401.

Надсилання запитів

Надсилайте запити з комп'ютера, IP-адреса якого є у вашому списку. Див. Облікові дані.

  1. Надішліть Your services. Очікуваний результат: список, у якому є ваш service_id.
  2. Надішліть Check the phone number. У консолі Postman видно, чи зареєстрований номер.
  3. Надішліть Subscribe. Очікуваний результат: "successful": true.
  4. Надішліть User services. У списку — ваша послуга з датою закінчення.
  5. Надішліть Unsubscribe, потім ще раз User services: результат [].

Кожен запит має тест, що перевіряє результат.

УВАГА

Subscribe і User services створюють користувача MEGOGO, якщо номер не зареєстрований. Використовуйте лише номер своєї тестової SIM-картки.

У колекції є також Suspend і Resume. Надсилайте Resume лише після Suspend. Див. Продовження, призупинення й відключення.

Змінні

Змінна За замовчуванням Опис
terminals_api https://billing.megogo.net Базовий URL API

Як скрипт підписує запит

Перед кожним запитом скрипт:

  1. Видаляє sign з URL.
  2. Записує приватний ключ, GET і шлях, підставивши значення змінних.
  3. Дописує всі ввімкнені query-параметри, відсортовані за назвою, у вигляді назва=значення.
  4. Обчислює хеш SHA-256, кодує шістнадцятковий текст у Base64, видаляє =, замінює / і + на - і дописує _ та публічний ключ.
  5. Додає sign до URL.

Якщо ви додасте до запиту параметр, скрипт включить його в підпис. Див. Підпис запиту.


Версія посібника 1.3.0, 2026-11-02 · Повідомити про проблему на цій сторінці