SberJson структура описания видеоконтента на метавитрине Салют ТВ
Данная документация описывает структуру данных для передачи информации о видеоконтенте, которая используется для формирования метавитрины контента на всех поверхностях Салют ТВ. Наполнение полей по каждой единице каталога влияют на его доступность на устройствах пользователей. Важным фактором является соблюдение требований по формату и обязательности заполнения полей, так как это влияет на визуальное отображение в метавитринах и каталоге контента.
Изменения с прошлой версии
- Добавлены требования к размеру и формату изображений
- Обновлен справочник доступных жанров контента
- Поля audioTracks и qualities стали необязательными
Принцип формирования и доставки данных
- Поставщик контента формирует статичную ссылку, на которой размещается выгрузка (фид). Файл выгрузки должен быть доступен по протоколу HTTPS на домене поставщика контента.
Пример ссылки на файл:
https://yoursite.ru/feed.json. Content-Type=application/json; charset=utf-8.
Ссылка может быть защищена паролем.
- Для верификации источника фида SberDevices поддерживаются в том числе и white-листы, в таком случае понадобится статичный IP-адрес.
SberDevices могут быть рассмотрены и иные технические особенности интеграции, для этого обсудите их с вашим контактным лицом в SberDevices.
- Производить обновление данных в файле выгрузки желательно не реже, чем один раз в сутки и не чаще, чем один раз в шесть часов.
При необходимости использования иных периодов обновления – обсудите это с вашим контактным лицом в SberDevices.
- Каждая единица контента задается отдельным объектом.
- Опции оплат задаются как массив в каждой единице контента.
- Сериальная матрица может отсутствовать.
- Если вами используются уникальные идентификаторы контента, сообщите об этом отдельно.
- При необходимости передавать новый тип контента необходимо согласовать добавление нового ТИПА, размещение в некорректных уже существующих типах контента запрещено.
- У единицы контента может быть указано несколько «жанров». Справочник доступных жанров приведен в комментарии к соответствующему полю.
- Маркировка возраста, эротики и порноконтента обязательна.
В случае отсутствия данных по полям помеченных в текущей документации как обязательные свяжитесь с вашим контактным лицом в SberDevices.
Полнота контента
- Ожидается, что поставщик предоставляет весь доступный контент, кроме UGC. Если имеющиеся типы не охватывают полноту каталога (например, спортивный контент), то свяжитесь с вашим контактным лицом в SberDevices для согласования добавления новых типов.
- Добавление UGC контента в фид имеет смысл при условии, что его использование запланировано совместно. Любые детали всегда можно уточнить у контактного лица в SberDevices.
- В фиде могут быть переданы подборки контента, как отдельный объект данных, их промо размещение (формат, срок, состав, стоимость и т.д.) согласуется отдельно через менеджера SberDevices.
- Если планируется отправка промоподборок и их обновление силами собственных контент-менеджеров, то возможно создание отдельных галерей конте нта с уникальными идентификаторами, которые далее необходимо сообщить менеджеру SberDevices.
Требования к размеру и формату изображений
Название | Формат | Размер, px |
Горизонтальные изображения covers | .webp | 640 х 360 |
Квадратные виджеты (square_small_type) | .webp | 640 х 640 |
Вертикальные изображения covers | .webp | 640 х 960 |
Фоновое изображение для карточки контента без логотипа/названия фильма/сериала thumbnails | .webp | 1920 х 1080 |
Изображение с названием/логотипом фильма/сериала titleImage | .png/.webp (с прозрачным фоном) | Максимальные размеры контейнера для изображения: |
Примеры использования изображений


Описание SberJson
Общая схема
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"created": "2024-01-30T21:00:00Z\n",
"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",
"keyNumber": "string",
"cards": [
{
"sequence": 0,
"id": "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"
],
"creators": [
{
"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "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 [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
]
Array [
- WEB
- ANDROID
]
Array [
- Тип автора
- Пользователь
- Группа
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 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)
Ориентация изображенияH:
краткое описание до 119 символов
Номер канала
cards
object[]
required
Массив для передачи контента галлереи
Последовательность элементов галлереи
ИД контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
creators
object[]
required
Создатель контента
Имя автора контента
Ссылка на автора
Ссылка на аватарку автора
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количество просмотров
Количество комментариев
ratings
object[]
required
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
required
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
required
Д оступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству (от 1 до n).
У каждого контента это независимо.
audioTracks
object[]
required
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
required
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
required
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стои мость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
required
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента 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 максимальное значение
- "kinopoisk" - 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)
Ориентация изображенияH:
краткое описание до 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
, значение данного поля не учитывается.
Пример формирования элемента SERIES
- Пример
- Описание
{
"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 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количество просмотров
Количество комментариев
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику: