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

Нижче описано типи контенту MEGOGO і те, як вони пов'язані між собою.

Об'єкти¶

Кожен елемент каталогу — це об'єкт із власним ID. В XML-фіді (object@id) і в Content API (id, video_id) використовується той самий 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 (серіал), prev і next.

Трейлери¶

У фільму або серіалу може бути один трейлер. Користувач може дивитися його без передплати й без токена доступу. Щоб відтворити трейлер, передайте його ID у /stream.

4K-версії¶

4K-версія фільму — окремий об'єкт. Її назва зазвичай закінчується на «UHD» або «UHD HDR», а в XML-фіді в неї є quality value="UHD". Показуйте 4K-версії, лише якщо 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 · Повідомити про проблему на цій сторінці