Глосарій
Нижче наведено терміни, які використовуються в посібнику.
Сторони та облікові записи
| Термін |
Визначення |
Назва в коді |
| MEGOGO |
Відеосервіс, що надає контент і API. |
— |
| партнер (partner) |
Компанія, яка показує контент MEGOGO у своєму застосунку й виставляє рахунки своїм користувачам. |
— |
| застосунок партнера (partner application) |
Вебзастосунок, мобільний застосунок, застосунок для Smart TV або телеприставки, у якому партнер показує контент MEGOGO. У посібнику — «ваш застосунок». |
— |
| користувач (user) |
Людина, яка дивиться контент MEGOGO в застосунку партнера. |
— |
| ID партнера (partner ID) |
Текстовий ID, який MEGOGO присвоює партнерові, наприклад testprod_ua. |
partnerId, partner_key |
| номер партнера (partner number) |
Номер облікового запису партнера. Збігається зі значенням partner_id у /configuration і в URL партнерського фіду. |
partner_id (configuration) |
| тестовий ID партнера (test partner ID) |
ID партнера для тестування в робочому середовищі (production), наприклад testprod_ua. |
partnerId |
| ідентифікатор користувача (user identifier) |
ID користувача в системі партнера — будь-який рядок довжиною до 255 символів, наприклад номер договору, логін або хеш. В усіх запитах для одного користувача передавайте те саме значення. |
identifier, userId, isdn |
| ID користувача MEGOGO (MEGOGO user ID) |
Внутрішній ID користувача в MEGOGO. |
uid, user_id |
Облікові дані та безпека
| Термін |
Визначення |
Назва в коді |
| пара ключів (key pair) |
Публічний і приватний ключі. MEGOGO видає окрему пару ключів для кожної платформи. У посібнику — «ключ». |
— |
| публічний ключ (public key) |
Частина пари ключів, яку дописують у кінець кожного підпису. |
public_key |
| приватний ключ (private key) |
Секретна частина пари ключів. Зберігайте її лише на своєму сервері. |
private_key |
| сіль (salt) |
Секретне значення, з яким обчислюється токен авторизації. Зберігайте його лише на своєму сервері. |
salt |
| підпис (signature) |
Значення, що підтверджує: запит надіслав саме партнер. |
sign |
| токен авторизації (authorization token) |
MD5-хеш ідентифікатора користувача, ID партнера й солі. |
token |
| токен доступу (access token) |
Значення, яке MEGOGO повертає після авторизації користувача. Діє приблизно 6 годин. |
access_token |
| токен «запам'ятати мене» (remember-me token) |
Довгостроковий токен (діє приблизно 5 років). Його надсилають у /auth/refresh, щоб отримати новий токен доступу. |
remember_me_token, rememberme_token |
| список IP-адрес (IP list) |
IP-адреси серверів партнера, з яких дозволено надсилати запити Billing API для керування послугами. |
— |
Контент
| Термін |
Визначення |
Назва в коді |
| об'єкт (object) |
Елемент каталогу з власним ID: фільм, серіал або 4K-версія. В XML-фіді й у Content API об'єкт має той самий ID. |
object, id |
| відео (video) |
Об'єкт або серія, що має потік: фільм, серія чи трейлер. |
video_id |
| фільм (film) |
Будь-яке відео, крім серіалу. |
item_type: video |
| серіал (series) |
Об'єкт, що складається із сезонів. |
item_type: series, is_series |
| сезон (season) |
Частина серіалу, що складається із серій. |
season, season_list |
| серія (episode) |
Окреме відео в сезоні. |
seria, item_type: episode |
| трейлер (trailer) |
Коротке безкоштовне відео з фрагментом фільму або серіалу. |
trailer_id, trailer |
| 4K-версія (4K version) |
Окремий об'єкт із фільмом у якості 4K (UHD). Назва такого об'єкта зазвичай закінчується на «UHD» або «UHD HDR». |
quality value="UHD", is_uhd |
| категорія (category) |
Основна група відео, наприклад Фільми або Серіали. |
category_id |
| жанр (genre) |
Група відео за тематикою, наприклад Комедія. |
genre |
| добірка (collection) |
Список відео, який складають редактори MEGOGO. Для деяких партнерів MEGOGO створює добірки на запит. |
collection |
| XML-фід (XML feed) |
Щоденний XML-файл з усіма об'єктами, які партнер може показувати. У посібнику також — «ваш фід». |
all_mgg.xml |
| регіональний фід (region feed) |
XML-фід регіону без номера партнера. Не використовуйте його; виняток — Польща. |
{region}/all_mgg.xml |
| ID контракту (contract ID) |
ID контракту на права для об'єкта. |
contract_id |
| токен сторінки (page token) |
Значення next_page з відповіді зі списком. Щоб отримати наступну сторінку, передайте його в параметрі page. |
next_page, page |
Монетизація
| Термін |
Визначення |
Назва в коді |
| модель доступу (delivery rule) |
Спосіб, у який користувач отримує відео: SVOD, AdVOD, FVOD, TVOD або DTO. |
delivery_rules, vod_type |
| партнерська передплата (partner subscription) |
Набір відео SVOD, AdVOD і FVOD, які партнер продає як передплату. Доступом своїх користувачів керує сам партнер. |
— |
| SVOD |
Доступ за передплатою. |
svod |
| AdVOD |
Відео, безкоштовне в застосунках MEGOGO. У застосунку партнера воно входить до партнерської передплати. Content API віддає потік такого відео без користувача. |
advod |
| FVOD |
У застосунку партнера — те саме, що AdVOD. |
fvod |
| TVOD |
Оренда: купівля одного відео на обмежений період. |
tvod |
| період оренди (rent period) |
Період дії купівлі TVOD. Починається з першої відповіді /stream, що містить src. |
period, dateFinish |
| DTO |
Купівля одного відео без обмеження в часі. Показуйте її користувачам як «назавжди». |
dto |
| послуга (service) |
Продукт, який MEGOGO реєструє для користувача: передплата або окрема купівля. ID послуг надає MEGOGO. |
serviceId |
| тариф (tariff) |
Поєднання ціни, періоду та якості послуги. |
tariff_id |
| пропозиція (offer) |
Послуга TVOD або DTO для відео в purchase_info; містить один або кілька тарифів. |
purchase_info.tvod, purchase_info.dto |
| передплата (subscription) |
Послуга SVOD, оформлена для користувача. |
subscription |
| автоматичне продовження (automatic renewal) |
Режим продовження, у якому MEGOGO щоперіоду продовжує передплату, доки партнер не надішле unsubscribe. |
— |
| продовження партнером (renewal by the partner) |
Режим продовження, у якому партнер сам продовжує передплату запитом subscribe. Кожен запит додає один період. |
— |
Відтворення
| Термін |
Визначення |
Назва в коді |
| URL потоку (stream URL) |
URL маніфесту, який використовує плеєр. |
src |
| маніфест (manifest) |
Файл HLS (.m3u8), DASH (.mpd) або MSS (Manifest) зі списком варіантів потоку. |
— |
| налаштування потоку (stream settings) |
Налаштування ключа: протокол, система DRM і 4K. Їх задає MEGOGO. |
stream_type, drm_type |
| якість (quality) |
Роздільна здатність відео, яку бачить користувач, наприклад «High (720)». Кожен елемент bitrates відповідає одній якості. |
bitrates, bitrate |
| аудіодоріжка (audio track) |
Мова або версія звуку відео, наприклад «Українська з аудіоописом». |
audio_tracks |
| обов'язкові субтитри (forced subtitles) |
Субтитри, які користувач не може вимкнути, якщо вибрано певну аудіодоріжку. |
require_subtitles, is_disableable: false, preselect |
| DRM |
Система шифрування потоку: Widevine, PlayReady або FairPlay. |
drm_type, protection |
| сервер ліцензій (license server) |
Сервер DRM, який видає плеєру ліцензію. |
license_server |
| обмеження (restriction) |
Причина, з якої користувач не може дивитися відео. |
restrictions |
| гео (geo) |
Країна, яку MEGOGO визначає для запиту. |
geo |
Версія посібника 1.4.1, 2026-10-31 · Повідомити про проблему на цій сторінці