Глоссарий
Термины, которые используются в этом руководстве.
Стороны и аккаунты
| Термин |
Определение |
Название в коде |
| 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-версия. ID объекта одинаков в XML-фиде и в Content API. |
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 · Сообщить о проблеме на этой странице