Каталог ошибок¶
Здесь собраны все коды ошибок Content API и Billing API и для каждого кода указано, что делать. Проблемы, у которых нет кода, описаны в разделе Решение проблем.
Как MEGOGO сообщает об ошибке¶
| Интерфейс | Формат |
|---|---|
| Content API | Большинство ошибок — HTTP 200 с "result": "error", code и message. Неверная подпись — HTTP 400 |
Content API, /stream |
Пользователь не может смотреть видео: HTTP 200, "result": "ok", пустой src и массив restrictions |
| Billing API | HTTP 200 с "successful": false. Код указан в конце message: "…, code 2023" |
| Billing API, доступ | HTTP 401 с обычным текстом, а не JSON |
Одного HTTP-статуса недостаточно — проверяйте тело ответа. Не показывайте
message пользователю: этот текст может меняться и может быть на
английском языке.
Повтор в таблицах: «Да» означает, что тот же запрос может позже
выполниться успешно. Выдерживайте между попытками 1 минуту и делайте не
больше 6 попыток. Прежде чем повторить subscribe или buyMovie,
проверьте услуги пользователя через user/subscriptions: эти запросы не
идемпотентны.
Content API¶
HTTP-статус / code |
Значение | Повтор | Что делать |
|---|---|---|---|
HTTP 400, "You entered wrong sign key" |
Неверная подпись или неизвестный публичный ключ | Нет | Проверьте порядок и значения параметров. См. Подпись запроса |
| HTTP 406, пустое тело | Неверный путь запроса | Нет | Убедитесь, что URL начинается с https://api.megogo.net/v1/ |
"code": 400 |
Параметр неверный или не передан | Нет | Сверьтесь со справочником по этому запросу |
"code": 403 |
Токен доступа неверный или истек | Нет | Получите новый токен доступа через /auth/refresh или /auth/by_partners |
"code": 404 |
Видео не найдено | Нет | Удалите видео из своего каталога |
| HTTP 429 | С этим ключом отправлено больше 1 000 запросов в минуту | Да | Снизьте частоту запросов и кешируйте ответы. См. Эксплуатация |
| HTTP 5xx, тайм-аут | Временный сбой | Да | Повторите запрос |
Ограничения воспроизведения (/stream)¶
Если src пустой, /stream возвращает в restrictions[].code один из
этих кодов. Те же коды может вернуть и /video/info. MEGOGO может
добавлять новые коды: если код вам неизвестен, сообщите пользователю, что
видео недоступно.
| Код | Значение | Что делать |
|---|---|---|
NOT_PURCHASABLE |
У пользователя нет подписки или покупки для этого видео либо в запросе нет access_token |
Предложите оформить подписку или покупку. Проверьте услуги пользователя через user/subscriptions |
NO_VOD_COUNTRY, NOT_ENABLED_IN_COUNTRY |
Видео недоступно в стране пользователя | Сообщите об этом пользователю и не показывайте видео в этой стране |
CONTRACT, NO_CONTRACT |
Видео не входит в ваш контракт | Удалите видео из своего каталога |
BIZ_CLASS |
Видео недоступно для платформы вашего ключа | Не показывайте видео на этой платформе. См. Платформы и права |
NO_BITRATE |
Для вашего ключа нет ни одного доступного качества — например, это 4K-версия, а настройки 4K у ключа нет | Не показывайте 4K-версии, если у ключа нет настройки 4K |
BITRATE_DISABLED_BY_PURCHASED_SUBSCRIPTION |
Услуга пользователя не включает это качество — например, у него тариф SD | Предложите услугу с этим качеством |
UHD_IS_NOT_SUPPORTED, HDR_IS_NOT_SUPPORTED, D3_IS_NOT_SUPPORTED |
Ключ не поддерживает 4K, HDR или 3D | Не показывайте такие версии с этим ключом |
DRM, NO_DRM_SUPPORT |
Видео защищено DRM, а ваш ключ DRM не поддерживает | Обсудите настройки DRM для ключа с вашим менеджером MEGOGO |
PARTNER_IS_DISABLED |
Ваша партнерская учетная запись отключена | Обратитесь к вашему менеджеру MEGOGO |
NO_SCHEDULE_FOR_CHANNEL, INVALID_VIRTUAL_OBJECT_ID, CATCH_UP_IS_UNAVAILABLE |
Коды для ТВ-каналов и просмотра в записи (catch-up). В этом руководстве они не описываются | — |
Billing API¶
| Код | Название | Значение | Повтор | Что делать |
|---|---|---|---|---|
| HTTP 401 | — | IP-адреса сервера нет в вашем списке или неверный ID партнера | Нет | Отправьте запрос с сервера из вашего списка. Новый адрес начинает работать через несколько минут после изменения |
| 400 | — | Запрос невозможно выполнить — например, buyMovie для видео, которое пользователь уже купил |
Нет | Проверьте user/subscriptions |
| 2009 | SUBSCRIPTION_NOT_SELLING | Подписка не продается | Нет | Сообщите в поддержку MEGOGO |
| 2010 | SUBSCRIPTION_NOT_FOUND | Подписка не найдена | Нет | Проверьте ID услуги. Сообщите в поддержку MEGOGO |
| 2012 | INVALID_PERMISSIONS | Неверные настройки подписки или тарифа | Нет | Сообщите в поддержку MEGOGO |
| 2013 | SUBSCRIPTION_NOT_GEO_PRESENTED | Подписка недоступна в регионе | Нет | Сообщите в поддержку MEGOGO |
| 2015 | OBJECT_NO_VOD_PERMISSION_FOR_SALE | У видео нет модели доступа для продажи | Нет | Не предлагайте покупку. Проверьте /video/info |
| 2016 | USER_SERVICE_CREATION_ERROR | MEGOGO не удается создать услугу пользователя | Да | Проверьте user/subscriptions и повторите запрос. Если ошибка повторится, сообщите в поддержку MEGOGO |
| 2017 | USER_SERVICE_NOT_FOUND | Услуга партнера не найдена | Нет | Проверьте ID услуги. Сообщите в поддержку MEGOGO |
| 2022 | TARIFF_ID_DOESNT_MATCH_ORDER_SERVICE_ID | Тариф с этим ID не относится к этой услуге | Нет | Передавайте tariff_id из /video/info |
| 2023 | PROLONGATION_DISABLED | Услуга уже активна (subscribe или resume) |
Нет | Ничего делать не нужно |
| 2027 | DATE_FINISH_OUT_OF_BOUNDS | Дата окончания отстояла бы от текущего момента больше чем на 5 лет | Нет | Не продлевайте услугу сейчас |
| 2029 | VOD_RULES_NOT_FOUND_FOR_OBJECT | У видео нет моделей доступа | Нет | Уберите предложение. Проверьте /video/info |
| 2031 | SUBSCRIPTION_QUALITY_FOR_OBJECT_NOT_FOUND | Этого качества видео нет в услуге | Нет | Выберите другой тариф из /video/info |
| 4001 | OBJECT_PREVIOUSLY_PURCHASED | Пользователь уже купил это видео | Нет | Ничего делать не нужно |
| 4003 | PARTNER_NOT_FOUND | Партнер не найден | Нет | Проверьте ID партнера в URL |
| 5001 | USER_NOT_FOUND | Пользователь не найден | Нет | Проверьте идентификатор пользователя. Для нового пользователя сначала отправьте subscribe, buyMovie или user/create |
| 40416 | — | ID услуги или ID тарифа не найден для вашего ID партнера | Нет | Используйте ID услуг, полученные от MEGOGO, и tariff_id из /video/info |
| 42901 | error.too_many_requests | Слишком много запросов: больше 1 000 в минуту с вашим ID партнера | Да | Снизьте частоту запросов |
| HTTP 5xx, тайм-аут | — | Временный сбой | Да | Проверьте user/subscriptions и повторите запрос |
Обращение в поддержку¶
Отправьте на адрес supportpartners@megogo.net ваш ID партнера, запрос (без ключей и токенов), ответ и время запроса в UTC.
Версия руководства 1.4.1, 2026-10-31 · Сообщить о проблеме на этой странице