Wgranie wideo API
Wgranie wideo API umożliwia bezpośrednie przesyłanie plików wideo i monitorowanie ich statusu procesowania.
Wszystkie przesyłania są przetwarzane asynchronicznie. Otrzymasz natychmiastową odpowiedź 202 Accepted, a wideo zostanie przetworzone w tle. Powinien używać punktów końcowych statusu, aby monitorować postęp.
Wgraj wideo
Ten punkt końcowy akceptuje żądanie multipart/form-data do przesłania nowego pliku wideo.
POST /uploads
Ciało żądania (multipart/form-data)
| Pola | Typ | Wymagane | Opis |
|---|---|---|---|
video | file | Tak | Plik wideo do przesłania. |
folder | string | Tak | Ścieżka katalogu, w którym powinien być umieszczony plik (np. root/mój-katalog). |
Przykładowe żądanie (.http)
POST /api/client/v1/uploads
Autoryzacja: Bearer sk-twoja-api-klucz-tutaj
Content-Type: multipart/form-data; granica=...
... (dane formularza z plikiem i folderem) ...Odpowiedź: 202 Accepted
Wydawca API potwierdza przesłanie i zwraca początkowy status. Powinieneś przechować id do sprawdzenia statusu później.
{
"message": "Przesłanie zaakceptowane i jest obecnie w trakcie przetwarzania.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Pobierz status przesyłania
Pobiera status ostatnich 50 przesłań. Możesz używać tego punktu końcowego do aktualizowania Twojej aplikacji.
GET /uploads
Przykładowe żądanie
GET /api/client/v1/uploads
Autoryzacja: Bearer sk-twoja-api-klucz-tutajOdpowiedź: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "mój_nowy_plik.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": "mój_poprzedni_plik.mp4",
"status": 6,
"status_text": "completed",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Pobierz status jednego przesyłania
Pobiera status jednego konkretnego wideo według jego ID.
GET /uploads/{videoId}
Przykładowe żądanie
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fOdpowiedź: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "mój_nowy_plik.mp4",
"status": 6,
"status_text": "completed"
}
}Referencja statusu
| Kod Statusu | Tekst Statusu | Opis |
|---|---|---|
1 | pending | Przesłanie jest w kolejce i czeka na przetworzenie. |
3 | processing | Wideo jest obecnie kodowane. |
5 | uploading | Kodowane pliki są przesyłane do ostatecznego magazynu. |
6 | completed | Wideo jest całkowicie przetworzone i gotowe do odtworzenia. |
7 | failed | Podczas przetwarzania wystąpił błąd. |