Перейти до змісту

Облікові дані

Перед початком інтеграції MEGOGO видає вам набір ID і ключів. Нижче описано, для чого потрібне кожне значення і як його захистити.

Що надає MEGOGO

Значення Приклад Де використовується Призначення
ID партнера {partner_id} Billing API (у шляху), /auth/by_partners (partner_key) Ідентифікує вашу компанію
Публічний ключ {public_key} Content API (sign) Ідентифікує пару ключів; дописується в кінець кожного підпису
Приватний ключ {private_key} Content API (sign) Потрібен для обчислення підпису. Ніколи не передавайте його в запиті
Сіль (salt) {salt} Токен авторизації Потрібна для обчислення токена авторизації користувача
ID послуг {service_id} Billing API (serviceId) Ідентифікують передплати й купівлі, які ви продаєте
Тестовий ID партнера й тестові ключі testprod_ua Усі запити Тестування на робочих серверах

Усі ці значення створює MEGOGO, змінити їх ви не можете.

Ключі для кожної платформи

Для кожної платформи MEGOGO видає окрему пару ключів (публічний і приватний):

  • веб;
  • мобільні пристрої;
  • Smart TV;
  • приставки (STB).

Набір доступного контенту для різних ключів може відрізнятися. Використовуйте ключ тієї платформи, на якій користувач дивиться відео.

Крім того, для кожного ключа MEGOGO задає налаштування потоку:

Налаштування Варіанти
Протокол передачі відео без DRM HLS, DASH або MSS
Система DRM і протокол для відео з DRM Widevine (DASH), PlayReady (DASH або MSS), FairPlay (HLS)
Відео 4K (UHD) Окреме налаштування з H.265: HLS або DASH без DRM, Widevine (DASH), PlayReady (DASH), FairPlay (HLS). Якщо налаштування порожнє, відео 4K з цим ключем не відтворюються

Повідомте вашого менеджера MEGOGO, які протоколи й системи DRM підтримує ваш плеєр на кожній платформі. Протокол потоку повертається у відповіді /stream у полі stream_type: hls, dash або mss.

ID послуг

  • Передплати (SVOD): MEGOGO надає текстові ID, наприклад premiumsvod. Зазвичай період передплати становить 30 днів. Для пробного доступу, наприклад на 7 або 14 днів, MEGOGO може надати окремі ID послуг.
  • Окремі купівлі (TVOD, DTO): ID послуги — число, а саме tariff_id, який Content API повертає для відео в purchase_info. Не беріть ID і ціни з XML-фіду.

Тестовий ID партнера

Окремого тестового середовища в MEGOGO немає. Тестовий ID партнера (наприклад, testprod_ua або testprod_az) і тестові ключі працюють на робочих серверах. Використовуйте їх для всіх тестів.

IP-адреси для Billing API

Billing API приймає запити лише з IP-адрес ваших серверів.

  1. Передайте список своїх IP-адрес вашому менеджеру MEGOGO.
  2. Щоб змінити список, напишіть на supportpartners@megogo.net і вкажіть у листі свій ID партнера.

На запит з IP-адреси, якої немає в списку, повертається HTTP 401 з текстовим повідомленням (не у форматі JSON).

Захист облікових даних

УВАГА

Зберігайте сіль лише на своєму сервері й не додавайте її в клієнтський застосунок. Маючи сіль і приватний ключ, сторонній може авторизуватися від імені будь-якого вашого користувача.

УВАГА

Зберігайте приватні ключі на своєму сервері. Якщо запити до Content API надсилає клієнтський застосунок, нехай він отримує підписаний URL від вашого сервера. Тоді запит надходить від клієнта, і MEGOGO визначає місцезнаходження користувача за IP-адресою клієнта.

УВАГА

Не залишайте облікові дані в репозиторії, журналах чи повідомленнях про помилки. Якщо облікові дані потрапили до сторонніх, негайно повідомте вашого менеджера MEGOGO.

Ліміти

Кожен ключ може надсилати до Content API 1 000 запитів на хвилину. Такий самий ліміт діє для Billing API. Якщо ліміт перевищено, MEGOGO може повернути HTTP 429 Too Many Requests. Щоб збільшити ліміт, зверніться до вашого менеджера MEGOGO.

Наступні кроки

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