Експлуатація¶

Правила щоденної роботи інтеграції: обмеження, повторні запити, журнали й зміни ваших серверів.

Обмеження¶

Кожен ID партнера може надсилати 1000 запитів на хвилину. Понад цю межу MEGOGO може повернути HTTP 429 Too Many Requests.

Не надсилайте user/subscriptions для всіх абонентів за розкладом. Надсилайте лише для абонентів, у яких щось змінилося.
Щоб збільшити ліміт, зверніться до менеджера MEGOGO.

Повторні запити¶

Повторюйте запит лише після таймауту або відповіді HTTP 5xx.

flowchart TD
    A[Таймаут або HTTP 5xx] --> B[user/subscriptions]
    B --> C{Перший запит змінив передплату?}
    C -- Так --> D[Зупиніться. Перший запит спрацював]
    C -- Ні --> E[Зачекайте 1 хвилину]
    E --> F[Надішліть запит знову]
    F --> G{Результат}
    G -- Таймаут або 5xx, менше 6 спроб --> B
    G -- Відповідь --> H[Готово]

Отримайте user/subscriptions для абонента. Переконайтеся, що перший запит не змінив передплату.
Якщо не змінив, надішліть запит знову.
Між спробами чекайте 1 хвилину. Максимум 6 спроб.

УВАГА

subscribe і resume не ідемпотентні: другий успішний запит може додати ще один період. Перед повторною відправкою завжди виконуйте крок 1.

Без перевірки можна повторювати unsubscribe, user/create, user/innerId і user/changeCredentials з тими самими значеннями: вони дають той самий результат.

Журнали¶

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

УВАГА

Не записуйте паролі абонентів у журнали. Зберігайте ідентифікатори й логіни в журналах відповідно до ваших правил захисту даних.

Зміни ваших серверів¶

subscription/{operation}, user/subscriptions і user/changeCredentials MEGOGO приймає лише з IP-адрес вашого списку.

УВАГА

До зміни IP-адрес ваших серверів надішліть нові адреси на supportpartners@megogo.net із вашим ID партнера. Запити з адреси, якої немає в списку, отримують HTTP 401.

Підтримка¶

Пишіть на supportpartners@megogo.net. Вкажіть:

свій ID партнера;
ідентифікатор абонента та uid з user/innerId;
запит і відповідь (без пароля);
час запиту в UTC.

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