Перейти к содержанию

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

Как подключить подписки 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 · Сообщить о проблеме на этой странице