Информация о видео

Возвращает информацию о запрошенном видео.

Формат запроса

GET https://backend.vh.yandex.ru/api/v1/{channel_id}/{library_id}/{video_id}

channel_id Идентификатор канала.

library_id Идентификатор библиотеки.

video_id Идентификатор видео.

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

{
  "update_time": {string}, 
  "embed_url": {string}, 
  "description": {string}, 
  "encode_status": {string}, 
  "parent_id": {string}, 
  "content_url": {string},
  "create_time": {string}, 
  "id": {string}, 
  "name": {string},
  "restriction_age": {string},
  "green_url": {string},
  "tags": [array of string]
} 

update_time Дата и время обновления информации о видео в формате ISO 8601 со смещением относительно UTC. Например, 2017-07-08T11:29:16+03:00.

embed_url URL кода вставки видео.

description Описание видео.

encode_status Статус конвертации видео. После загрузки видео конвертируется в формат, который используется для показа пользователю. Допустимые значения:

  • converted — конвертация видео прошла успешно;

  • failed — конвертация видео завершилась ошибкой, попробуйте загрузить файл еще раз;

  • processing — конвертация видео еще не завершена, подождите несколько минут.

create_time Дата и время создания видео в формате ISO 8601 со смещением относительно UTC. Например, 2017-07-08T11:29:16+03:00.

content_url Ссылка на hls-мастерплейлист, который будет проигрываться в нативных плеерах.

parent_id Идентификатор библиотеки.

id Идентификатор видео.

name Название видео.

restriction_age Возрастное ограничение.

green_url Ссылка на источник.

tags Массив тегов.

Пример

Запрос:

curl -i -X GET 'https://backend.vh.yandex.ru/api/v1/4291f9134c516965b1cc8f65f1fd6ec5/479b9fed3060315ca845586253541c86/4bb704cecb0f57b5b1c6340fb4118cfd' -H 'Authorization: OAuth fefernrjkgnerkj3453445...'

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "update_time": "2019-01-30T18:52:10", 
  "embed_url": "https://frontend.vh.yandex.ru/player/1402321207336255756", 
  "description": "new video for test", 
  "encode_status": "converted", 
  "parent_id": "479b9fed3060315ca845586253541c86", 
  "create_time": "2019-01-30T15:36:19",
  "content_url": "https://strm.yandex.ru/vh-special-converted/vod-content/14834016254016986623.m3u8", 
  "id": "4bb704cecb0f57b5b1c6340fb4118cfd", 
  "name": "first_video",
  "tags" : [
      "breaking",
      "sport_hockey"
  ],
  "restriction_age" : "42",
  "green_url" : "https://example.org/"
}