Решение проблем¶

Найдите свою проблему в таблицах ниже: в каждой строке указаны причина и что делать. Все коды ошибок собраны в каталоге ошибок.

Как распознать ошибку¶

Интерфейс	Формат ошибки
Content API	Большинство ошибок — HTTP 200 с `"result": "error"` и `code`. Неверная подпись — HTTP 400
Content API, `/stream`	Пользователь не может смотреть видео: HTTP 200, `"result": "ok"`, пустой `src` и `restrictions`
Billing API	HTTP 200 с `"successful": false` и кодом в конце `message`
Billing API, доступ	HTTP 401 с обычным текстом, а не JSON

Одного HTTP-статуса недостаточно — всегда проверяйте тело ответа.

Запросы и подписи¶

Проблема	Причина	Что делать
HTTP 400, «You entered wrong sign key»	Неверная подпись	Берите параметры в том порядке, в котором они идут в URL, и в декодированном виде. Включайте в подпись `access_token`, `page` и `lang`. См. Подпись запроса
HTTP 406 с пустым телом	Неверный путь	Убедитесь, что URL начинается с `https://api.megogo.net/v1/`
`"code": 400`	Параметр неверный или не передан	Сверьтесь со справочником по этому запросу
`"code": 404`	Видео не найдено	Удалите видео из своего каталога
HTTP 429	Больше 1 000 запросов в минуту на ключ	Снизьте частоту запросов и используйте кеш. См. Эксплуатация
Текст приходит на русском языке	В запросе нет `lang`	Передавайте `lang` в каждом запросе

Авторизация¶

Проблема	Причина	Что делать
«The entered login or password is incorrect»	Неверный `token`	Заново вычислите `md5(user_id + partner_id + salt)`. Используйте тот же идентификатор пользователя, что и в Billing API
`"code": 403`	Токен доступа неверный или истек	Получите новый токен через `/auth/refresh` или `/auth/by_partners`
`/auth/refresh` возвращает `"code": 400`	Неверный токен «запомнить меня» или параметр назван `remember_me_token`	Назовите параметр `rememberme_token` или пройдите авторизацию заново

Воспроизведение¶

`restrictions[].code` или проблема	Причина	Что делать
`NOT_PURCHASABLE`	У пользователя нет подписки или покупки для этого видео либо в запросе нет `access_token`	Предложите оформить подписку или покупку. Проверьте услуги пользователя через `user/subscriptions`
`CONTRACT`, `NO_CONTRACT`	Видео не входит в ваш контракт	Не показывайте видео
`NO_VOD_COUNTRY`, `NOT_ENABLED_IN_COUNTRY`	Видео недоступно в стране пользователя	Сообщите об этом пользователю и не показывайте видео в этой стране
`NO_BITRATE`	Для вашего ключа нет ни одного доступного качества — например, это 4K-версия, а настройки 4K у ключа нет	Не показывайте 4K-версии, если у ключа нет настройки 4K
`NO_DRM_SUPPORT`, `DRM`	Видео защищено DRM, а ваш ключ DRM не поддерживает	Обсудите DRM с вашим менеджером MEGOGO
Плеер не воспроизводит `src`	Плеер не поддерживает протокол или систему DRM	Проверьте `stream_type` и `drm_type`. Попросите MEGOGO изменить настройки ключа
HTTP 404 при запросе манифеста после смены аудиодорожки	`index` взят не из `audio_tracks`	Используйте только значения `index` из ответа
В плеере больше аудиодорожек, чем в `audio_tracks`	В манифесте есть аудиодорожки, которые не предназначены для вашего ключа	Скройте их, сопоставляя аудиодорожки по `lang_tag`
`audio_tracks` пустой или в нем нет какой-то аудиодорожки видео	У видео есть только аудиодорожки 5.1 или аудиодорожки с обязательными субтитрами, а ваш ключ их не допускает	Не показывайте видео или обратитесь к вашему менеджеру MEGOGO
Арендованное видео доступно меньше дней, чем ожидалось	Период аренды начался с первого запроса `/stream`	Отправляйте `/stream` только тогда, когда пользователь запускает воспроизведение

Биллинг¶

Код или проблема	Причина	Что делать
HTTP 401, `Partner … not found`	IP-адреса нет в списке или неверный ID партнера	Отправьте запрос с сервера из списка. Новый адрес начинает работать через несколько минут после изменения
2023	Услуга уже активна	Ничего делать не нужно
2027	Дата окончания оказалась бы позже чем через 5 лет от текущей даты	Не продлевайте услугу сейчас
400	Пользователь уже купил это видео	Ничего делать не нужно
40416	ID услуги или ID тарифа не найден для вашего ID партнера	Используйте ID услуг, полученные от MEGOGO, и `tariff_id` из `/video/info`
5001	Пользователь не найден	Проверьте идентификатор пользователя
2009, 2010, 2012, 2013, 2015, 2016, 2017, 2022, 2029, 2031, 4003	Неверно настроены услуга, тариф или видео	См. Каталог ошибок. Сообщите в поддержку MEGOGO время запроса и код
Тайм-аут, HTTP 5xx	Временная проблема	Проверьте `user/subscriptions` и повторите запрос. Выдерживайте между попытками 1 минуту, всего не более 6 попыток

XML-фид¶

Проблема	Причина	Что делать
Время генерации в первом комментарии — не сегодняшнее	Новый фид еще не готов	Оставьте предыдущий каталог и загрузите фид позже. Фид готов после 05:00 UTC
HTTP 404	Неверный URL	Используйте URL, который вам выдал MEGOGO
Объект есть в фиде, но `/stream` возвращает ограничение	Объекту нужна настройка, которой нет у вашего ключа (DRM, 4K), или флаг платформы равен `0`	Отфильтруйте объекты, как описано в инструкции Создание и обновление каталога
Цены в фиде не совпадают с ценами ваших предложений	В фиде указаны тарифы MEGOGO	Берите цены из `/video/info`

Контакты¶

Сообщите о проблеме в поддержку MEGOGO по адресу supportpartners@megogo.net. Укажите ваш ID партнера, запрос (без ключей и токенов), ответ и время (UTC).

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