Încărcarea de Video API
Încărcarea de Video API oferă posibilitatea de a încărca direct fișierele video și de a monitoriza starea lor de procesare.
Toate încărcările sunt procesate asincron. Vei primi o răspuns imediat 202 Accepted și video-ul va fi procesat în fundal. Trebuie să folosești endpoint-urile de stare pentru a monitoriza progresul.
Încarcarea unui Video
Acest endpoint acceptă o cerere multipart/form-data pentru încărcarea unui nou fișier video.
POST /uploads
Corpul Cererii (multipart/form-data)
| Câmp | Tip | Reținut | Descriere |
|---|---|---|---|
video | file | Da | Fișierul video pentru a fi încărcat. |
folder | string | Da | Calea colecției unde video-ul ar trebui să fie plasat (de exemplu, root/my-folder). |
Exemplu de Cerere (.http)
POST /api/client/v1/uploads
Autorizare: Bearer sk-your-api-cheie-aici
Conținut-Tip: multipart/form-data; limită=...
... (datele formei cu fișier și foldere) ...Răspuns: 202 Accepted
Răspunsul API confirmă încărcarea și returnează starea inițială. Trebuie să păstrați id pentru a verifica starea ulterioară.
{
"mesaj": "Încărcarea acceptată și este acum în curs de procesare.",
"date": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"stare": 1,
"text_stare": "pending"
}
}Obține Starea Încărcării
Retrimite starea ultimelor 50 de încărcări. Poți să folosești acest endpoint pentru a actualiza UI-ul tău.
GET /uploads
Exemplu de Cerere
GET /api/client/v1/uploads
Autorizare: Bearer sk-your-api-cheie-aiciRăspuns: 200 OK
{
"date": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"numele_fisierului": "my_new_video.mp4",
"stare": 3,
"text_stare": "processing",
"creat_la": "2024-08-11T10:00:00Z",
"actualizat_la": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"numele_fisierului": "my_previous_video.mp4",
"stare": 6,
"text_stare": "completed",
"creat_la": "2024-08-10T15:00:00Z",
"actualizat_la": "2024-08-10T15:05:00Z"
}
]
}Obține Starea Încărcării Unică
Retrimite starea unui video specific prin ID-ul său.
GET /uploads/{videoId}
Exemplu de Cerere
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRăspuns: 200 OK
{
"date": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"numele_fisierului": "my_new_video.mp4",
"stare": 6,
"text_stare": "completed"
}
}Referință de Stare
| Codul Status | Textul Stare | Descriere |
|---|---|---|
1 | pending | Încărcarea este în coada și așteaptă să fie procesată. |
3 | processing | Video-ul este în curs de transcodificare. |
5 | uploading | Fișierele transcodificate sunt încărcate în stocaj final. |
6 | completed | Video-ul este complet procesat și gata pentru redare. |
7 | failed | A apărut o eroare în timpul procesării. |