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

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

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

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

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

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

  1. Складіть список ідентифікаторів абонентів з ID послуги для кожного.
  2. Приберіть пробіли на початку й у кінці кожного ідентифікатора. Використовуйте той самий вигляд ідентифікатора, що й в усіх інших ваших запитах.
  3. Приберіть дублікати. Регістр не має значення: ABC-1 і abc-1 — той самий абонент.

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

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

Для кожного абонента:

  1. Отримайте user/subscriptions. Якщо послуга вже активна, не надсилайте subscribe: у режимі «продовження партнером» він додасть ще один період. User not found означає, що передплати в абонента немає.
  2. Надішліть subscribe.
  3. Якщо в абонента немає логіна MEGOGO, надішліть user/changeCredentials. Див. Підключення передплати.
  4. Запишіть результат для абонента у своїй системі.

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

УВАГА

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

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

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

Крок 4. Повідомте абонентів

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

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