Експлуатація¶
Тут зібрано правила, які забезпечують стабільну й безпечну роботу інтеграції в робочому середовищі: ліміти, кешування, повторні спроби, журнали та безпека. Перш ніж відкрити сервіс користувачам, пройдіть чек-лист запуску.
Ліміти¶
| Інтерфейс | Ліміт | Після перевищення |
|---|---|---|
| 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 · Повідомити про проблему на цій сторінці