Загрузка видео API
Функция загрузки видео позволяет напрямую загружать видеофайлы и отслеживать статус их обработки.
Все загрузки обрабатываются асинхронно. Вы получите немедительный ответ 202 Accepted, а видео будет обрабатываться в фоновом режиме. Для отслеживания прогресса используйте конечные точки статуса.
Загрузка видео
Этот конечный пункт принимает запрос multipart/form-data для загрузки нового видеофайла.
POST /uploads
Тело запроса (multipart/form-data)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
video | file | Да | Загружаемый видеофайл. |
folder | string | Да | Путь коллекции, где видео должно быть размещено (например, root/my-folder). |
Пример запроса (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-here
Content-Type: multipart/form-data; boundary=...
... (формат данных с файлом и папкой) ...Ответ: 202 Accepted
Конечная точка API подтверждает загрузку и возвращает первоначальный статус. Храните id для проверки статуса позже.
{
"message": "Загрузка принята и сейчас обрабатывается.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Получение статуса загрузки
Получает статус последних 50 загрузок. Вы можете периодически вызывать эту конечную точку для обновления своего UI.
GET /uploads
Пример запроса
GET /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-hereОтвет: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 3,
"status_text": "processing",
"created_at": "2024-08-11T10:00:00Z",
"updated_at": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filename": "my_previous_video.mp4",
"status": 6,
"status_text": "completed",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Получение статуса отдельной загрузки
Получает статус одного конкретного видео по его ID.
GET /uploads/{videoId}
Пример запроса
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fОтвет: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "my_new_video.mp4",
"status": 6,
"status_text": "completed"
}
}Справочник статусов
| Код статуса | Текст статуса | Описание |
|---|---|---|
1 | pending | Загрузка находится в очереди и ожидает обработки. |
3 | processing | Видео сейчас обрабатывается. |
5 | uploading | Перетворенные файлы загружаются на конечное хранилище. |
6 | completed | Видео полностью обработано и готово к воспроизведению. |
7 | failed | При обрабатывании произошла ошибка. |