Эксплуатация¶

Здесь собраны правила, которые помогут интеграции стабильно и безопасно работать в рабочей среде: лимиты, кеширование, повторные запросы, журналы и безопасность. Прежде чем открыть сервис пользователям, пройдите чек-лист запуска.

Лимиты¶

Интерфейс	Лимит	При превышении лимита
Content API	1 000 запросов в минуту на каждый ключ	HTTP 429 Too Many Requests
Billing API	1 000 запросов в минуту на каждый ID партнера	HTTP 429 или код 42901 в теле ответа

Заголовков с информацией о лимитах (rate limit) в ответах нет. Чтобы увеличить лимит, обратитесь к вашему менеджеру MEGOGO.

Кеш¶

Данные	Правило
`/configuration`	Храните в кеше и обновляйте раз в день
XML-фид	Загружайте раз в день, после 05:00 UTC
Запросы списков без `access_token`	Можно кешировать на несколько минут
`/video/info`	Отправляйте только в ответ на действие пользователя, например когда он открывает страницу видео. Не собирайте с помощью этого запроса данные о большом количестве видео
`/stream` (`src`)	Не кешируйте. Отправляйте новый запрос каждый раз, когда пользователь запускает воспроизведение
Токен доступа	Храните до `access_token_expires_at`, затем получите новый токен через `/auth/refresh`

Повторные запросы¶

Content API:

Получив HTTP 429, подождите и снизьте частоту запросов.
После тайм-аута или HTTP 5xx запрос можно повторить.

Billing API:

Повторяйте запрос только после тайм-аута или HTTP 5xx.
Перед повтором отправьте user/subscriptions и убедитесь, что первый запрос не изменил услугу: subscribe и buyMovie не идемпотентны.
Выдерживайте между попытками 1 минуту. Всего допускается не более 6 попыток.

Если ошибка пришла в теле ответа (например, код 2023 или 40416), не повторяйте запрос: результат будет тем же. Какие ошибки допускают повторный запрос, указано в каталоге ошибок.

Журналы¶

Рекомендуем записывать в журнал все запросы к Billing API и ответы на них с указанием времени (UTC). Сообщая о проблеме в поддержку MEGOGO, укажите время и код ошибки.

ВНИМАНИЕ

Не записывайте в журналы приватные ключи, соль, токены доступа, токены «запомнить меня» (remember-me) и URL из src.

Безопасность¶

Храните приватные ключи и соль только на своих серверах. Клиентское приложение получает от вашего сервера уже подписанные URL.
Отправляйте запросы к Billing API только со своих серверов: MEGOGO принимает их лишь с IP-адресов из вашего списка. Чтобы изменить список, напишите на supportpartners@megogo.net и укажите ваш ID партнера. Новый адрес начинает работать через несколько минут после изменения.
Позаботьтесь о том, чтобы пользователь мог смотреть видео AdVOD и FVOD только при наличии вашей подписки: Content API отдает эти потоки без привязки к пользователю.
Если ключ, соль или токен попали к посторонним, немедленно сообщите вашему менеджеру MEGOGO.

Время¶

Все значения времени в Content API, Billing API и XML-фиде указаны в UTC. Unix-время указывается в секундах.

Тестирование и рабочая среда¶

Отдельной тестовой среды у MEGOGO нет: тестовый ID партнера и тестовые ключи работают на рабочих серверах. Тестовые подписки и покупки — это реальные записи в биллинге MEGOGO, оформленные на тестового партнера.

Версия руководства 1.4.1, 2026-10-31 · Сообщить о проблеме на этой странице