Пример формирования элемента TVCHANNEL

Обновлено 7 августа 2025

• Пример
• Описание

{
  "provider": "videoprovider",
  "version": "string",
  "contents": [
    {
      "contentId": "string",
      "type": "string",
      "title": "string",
      "customLabels": [
        "string"
      ],
      "originalTitle": [],
      "description": "string",
      "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",
      "ratings": [
        {
          "provider": "string",
          "value": "8.7"
        }
      ],
      "specialContentTag": [
        "string"
      ],
      "countries": [
        "RUS"
      ],
      "genres": [
        "string"
      ],
      "similar": [
        "string"
      ],
      "ageRestrictions": "string",
      "externalIds": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "qualities": [
        {
          "value": "Full HD",
          "sequence": "SD=1 HD=2"
        }
      ],
      "availability": true,
      "availabilityStartDate": "2026-03-14T21:00:00Z",
      "availabilityEndDate": "2026-03-14T23:59:00Z",
      "purchaseOptions": [
        {
          "id": "string",
          "title": "string",
          "consumptionMode": "string",
          "qualities": [
                            "FHD",
                            "HD",
                            "SD"
                          ],
          "price": "При цене 39999 -  сохранится как 399",
          "currency": "rub"
        }
      ]
    }
  ]
}

provider

string

required

Название поставщика

version

string

Версия фида:

• 2.03
• 2.02
• 2.01

contents object[]required

Array [

contentId

string

required

Идентификатор контента

type

string

required

Возможные значения:

• MOVIE
• SERIES,
• TVSHOW
• GALLERY
• UGC
• TVCHANNEL

title

string

required

Название

customLabels

string[]

Любой список тегов или лейблов, относящихся к данному уровню контента

originalTitle

string

Оригинальное название

description

string

Описание контента
Если значение не пустое, то применяются валидационные правила.

covers object[]required

Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации

Array [

link

string

required

Ссылка на кавер

resolution

string

Разрешение изображения

sequence

number

Последовательность каверов (от 1 до n)

orientation

string

Ориентация кавера:
H - Horizontal V - Vertical

]

titleImage object

Изображение с логотипом/названием контента

link

string

resolution

string

Разрешение изображения

thumbnails object[]

Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)

Array [

link

string

required

resolution

string

required

Разрешение изображения

sequence

number

required

Последовательность каверов (от 1 до n)

orientation

string

required

Ориентация изображенияH:

• H - Horizontal
• V - Vertical

]

shortDescription

string

краткое описание до 119 символов

keyNumber

string

required

Номер канала

cards object[]

Массив для передачи контента галлереи

Array [

sequence

number

Последовательность элементов галлереи

id

string

ИД контента

]

links object[]

Ссылки на контент

Array [

type

string

Тип ссылки:

• WEB
• ANDROID

value

string

Ссылка на контент

]

trailers

string[]

Ссылка на трейлер

streamPreview

string

Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика) deepLink: type: string description: Ссылка на автора icon: type: string description: Ссылка на аватарку автора

ratings object[]

Информация о рейтингах контента

Array [

provider

string

Обязательно для эксклюзивного контента:

• "imdb"
• "kinopoisk"
• "Ivi"
• "mgg"
• "okko"
• "afisha

value

string

Значение рейтинга
Валидация значений:

• "imdb" - 10 максимальное значение
• "kinopoisk" - 10 максимальное значение
• "okko" - 5 максимальное значение

]

specialContentTag

string[]

Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.

countries

string[]

Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3

genres

string[]

required

Массив с жанрами контента по справочнику:

• Аниме
• Артхаус
• Биографии
• Боевики
• Вестерны
• Военные
• Детективы
• Для взрослых
• Документальные
• Драмы
• Игровые-шоу
• Исторические
• Комедии
• Концерты
• Короткометражки
• Криминал
• Мелодрамы
• Мистические
• Музыкальные
• Мультфильмы
• Мюзиклы
• Нуар
• Приключения
• Развивающие
• Реалити
• Семейные
• Спорт
• Ток-шоу
• Триллеры
• Ужасы
• Фантастика
• Фэнтези
• Церемонии
  Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска.

similar

string[]

Массив для перечисления идентификаторов похожего контента

ageRestrictions

string

required

Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]

externalIds object[]

Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.

Array [

name

string

Название внешних каталогов:

• "imdb_id"
• "kinopoisk_id"

value

string

Идентификатор контента в каталоге

]

qualities object[]required

Доступные разрешения видео (стримов)

Array [

value

string

Название разрешения

sequence

number

Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.

]

availability

boolean

Доступность контента. По умолчанию присваиваем true

availabilityStartDate

string

Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability)

availabilityEndDate

string

Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability и значение поля availabilityStartDate).
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля учитываться не буде

purchaseOptions object[]required

Массив с опциями покупки

Array [

id

string

Идентификатор опциии оплаты

title

string

Название опции оплаты

consumptionMode

string

Способ потребления:

• "svod" — контент доступен по подписке;
• "tvod" — аренда контента;
• "fvod" — бесплатный контент;
• "avod" — контент за рекламу;
• "est" — покупка контента.

qualities

string[]

Массив качеств контента, на которые распространяется предложение

price

integer

Стоимость до копеек

currency

string

Код валюты по стандарту ISO 4217 альфа-3

]

]