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

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

  1. Формат запроса
  2. Формат ответа
  3. Пример

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

GET https://backend.vh.yandex.ru/api/v1/{channel_id}/{library_id}/{video_id}
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/"
}