Пример формирования элемента MOVIE
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": [
"string"
],
"directors": [
"string"
],
"cameramen": [
"string"
],
"producers": [
"string"
],
"artists": [
"string"
],
"composers": [
"string"
],
"screenwriters": [
"string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H — Horizontal
- V — Vertical
]
Array [
- WEB
- ANDROID
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" — 10 максимальное значение — 10 максимальное значение
- "okko" — 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска Array [
- H - Horizontal (горизонтальный)
- V - Vertical (вертикальный)
]
Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3.
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров — указывае м "no_subtitle".
Array [
- "svod" — Контент доступен по подписке
- "tvod" — Покупка или аренда контента
- "fvod" — Бесплатный контент
- "avod" — Контент за рекламу
- "est" — покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" — Контент доступен по подписке
- "tvod" — Покупка или аренда контента
- "fvod" — Бесплатный контент
- "avod" — Контент за рекламу
- "est" — Покидает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal (горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента.
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Длительность контента в миллисекундах.
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H — горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H — Horizontal,
V — Vertical
titleImage
object
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H — горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображения:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Сс ылка на превью видео
(обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Колич ество лайков
Количество просмотров
Количество комментариев
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес-логику
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id, это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству (от 1 до n). У каждого контента это независимо
audioTracks
object[]
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается
purchaseOptions
object[]
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента.
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается