Загрузка видео по ссылке
Загружает видео по публичной ссылке и ставит его в очередь на обработку.
Поддерживаются:
- публичная ссылка Яндекс.Диска на видеофайл;
- прямая ссылка на видеофайл;
- ссылка на плеер видеоплатформы Яндекс KITᵝ — возвращается ранее загруженное видео.
Ссылка должна быть доступна без авторизации. Если по ссылке нет видео,
метод вернет ошибку 400.
В ответе возвращается идентификатор видео — используйте его, чтобы отслеживать
статус обработки через GET /v1/videos/{video_id} и привязывать видео
к товару через media в POST /v1/variants и PATCH /v1/variants/{id}.
Ограничения
- максимальный размер файла — 100 МБ;
- поддерживаемые форматы: mp4, mov, webm, avi, flv;
- видео дедуплицируются по содержимому: повторная загрузка того же файла не создает дубликат, а возвращает уже загруженное видео;
Request
POST
https://api.kit.yandex.net/v1/videos/from_url
Body
application/json
{
"url": "https://disk.yandex.ru/i/abcdef123456"
}
|
Name |
Description |
|
url |
Type: string<uri> Публичная ссылка на видео: ссылка на видеофайл с Яндекс Диска, прямая ссылка на видеофайл или ссылка на плеер видеоплатформы Яндекс KITᵝ. Min length: Example: |
Responses
201 Created
Видео успешно загружено.
Body
application/json
{
"video_id": "vplvusemmooxmhpwiqli"
}
|
Name |
Description |
|
video_id |
Type: VideoID Идентификатор видео. Min length: Example: |
VideoID
Идентификатор видео.
Type: string
Min length: 1
Example: vplvusemmooxmhpwiqli
400 Bad Request
Некорректный запрос.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
401 Unauthorized
Не авторизован.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
404 Not Found
Ресурс не найден.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |