Възпреемни за видео API
В Uploads API се предоставя възможността да се качат директно видеофайлове и да се следи статуса на обработката им.
Всички качвания се изпълняват асихронно. Вие ще получите моментален 202 Accepted отговор, а видеото ще бъде обработено в заден план. Следователно трябва да използвате endpoint-ите за следене на прогреса.
Качване на видео
Този endpoint приема запитание 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 качвания. Вие можете да ползвате този endpoint за обновяване на 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 | Срещна се грешка по време на изпълнение. |