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

Масове підключення

Як підключити передплати MEGOGO багатьом користувачам одночасно, наприклад коли ви переводите своїх наявних абонентів на MEGOGO.

Перед початком

  • В API немає запиту для багатьох користувачів. Надсилайте окремий subscribe для кожного номера телефону.
  • Кожен ID партнера може надсилати 1000 запитів за хвилину. Понад ліміт MEGOGO може повернути HTTP 429.
  • Кожна нова передплата починається від поточного моменту й отримує повний період послуги. Задати дату початку чи закінчення не можна.
  • Радимо заздалегідь повідомити менеджерові MEGOGO дату й кількість користувачів.

Крок 1. Підготуйте список

  1. Складіть список номерів телефонів з ID послуги для кожного номера.
  2. Вилучіть номери не в міжнародному форматі або не лише з цифр.
  3. Вилучіть дублікати.

Крок 2. Надішліть запити

flowchart TD
    A[Наступний номер зі списку] --> B[subscriptions з phone]
    B --> C{Послуга активна?}
    C -- Так --> E[Записати: вже активна]
    C -- Ні --> D[subscribe]
    D --> F{Результат}
    F -- successful: true --> G[Записати: підключено]
    F -- Код 2023 --> E
    F -- Інша помилка --> H[Записати: помилка, перевірити пізніше]
    F -- Таймаут або 5xx --> B
    E --> A
    G --> A
    H --> A

Для кожного номера:

  1. Отримайте subscriptions з номером телефону. Якщо послуга вже активна, не надсилайте subscribe: у режимі «продовження партнером» він додасть ще один період.
  2. Надішліть subscribe.
  3. Запишіть результат для номера у своїй системі.

На кожен номер потрібно два запити. Тримайте швидкість нижче ліміту, щоб ваші інші запити теж проходили: наприклад, 400 номерів за хвилину (800 запитів). Якщо отримали HTTP 429, зачекайте 1 хвилину й продовжуйте.

УВАГА

Після таймауту або відповіді HTTP 5xx почніть із кроку 1 для цього номера. Див. Повторні запити.

Крок 3. Перевірте результат

  1. Для номерів з помилкою знайдіть причину в каталозі помилок і надішліть запити ще раз.
  2. Для кількох номерів ще раз отримайте subscriptions і переконайтеся, що послуга активна.

Крок 4. Повідомте користувачів

MEGOGO не надсилає користувачам повідомлень. Повідомте кожному користувачеві, як увійти в MEGOGO. Див. Підключення передплати.

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