Каталог помилок¶
Тут зібрано всі коди помилок 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 · Повідомити про проблему на цій сторінці