Модель контента¶

Какие типы контента есть в MEGOGO и как они связаны между собой.

Объекты¶

Каждый элемент каталога — это объект со своим ID. ID одинаков в XML-фиде (object@id) и в Content API (id, video_id).

Объект	XML-фид	Content API	Есть поток
Фильм	`serial="false"`, `type` — например, `FILM`, `MULTFILM`	`item_type: video`	Да
Сериал	`serial="true"`, `type` — например, `SERIAL`, `SHOW`	`item_type: series`, `is_series: true`	Нет, воспроизводятся его серии
Сезон	Элемент `season`	`season_list[]` в `/video/info`	Нет
Серия	Элемент `seria`	`item_type: episode`	Да
Трейлер	`trailer@id`	`trailer_id` в `/video/info`	Да, бесплатный

flowchart TD
    S[Сериал] --> S1[Сезон 1]
    S --> S2[Сезон 2]
    S1 --> E1[Серия 1]
    S1 --> E2[Серия 2]
    S2 --> E3[Серия 1]
    F[Фильм] --> T[Трейлер]
    S --> T2[Трейлер]

Сериалы, сезоны и серии¶

Для сериала /video/info возвращает season_list. У каждого сезона есть id, order, total (число серий) и episode_list.
Список серий в episode_list заполнен только у первого сезона. Серии остальных сезонов запрашивайте через /video/episodes?id={season_id}.
Чтобы воспроизвести серию, передайте ее ID в /stream. В ответе будут root_video_id (ID сериала), prev и next.

Трейлеры¶

У фильма или сериала может быть один трейлер. Его можно смотреть без подписки и без токена доступа — достаточно передать ID трейлера в /stream.

4K-версии¶

4K-версия фильма — это отдельный объект. Ее название обычно заканчивается на «UHD» или «UHD HDR», а в XML-фиде у нее указано quality value="UHD". Показывайте такие объекты, только если MEGOGO включил 4K для вашего ключа. Подробнее — в разделе DRM.

Категории и жанры¶

Категории и жанры возвращает /configuration:

categories[]: id, title, genres (ID жанров категории). ID категории передавайте в /video?category_id={id}.
genres[]: id, title.

В XML-фиде те же категории находятся в object/categories/category.

Некоторые категории (например, ТВ или аудиокниги) могут присутствовать в списке, но не входить в ваш контракт. Показывайте только категории, в которых есть видео для вашего ключа.

Язык текстов¶

Content API возвращает тексты на языке, заданном в lang. В XML-фиде тексты даны на языке файла (например, в all_mgg.xml — на русском). Подробнее — в справочнике XML-фида.

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