Video Uppladdningar API
Den här uppladdningsfunktionen ger dig möjlighet att direkt ladda upp videofiler och övervaka deras bearbetningstillstånd.
Alla uppladdningar behandlas asynkront. Du kommer att få ett omedelbart 202 Accepted svar, och videon kommer att behandlas i bakgrunden. Du bör använda statusändpunkterna för att övervaka framsteg.
Lägg upp en Video
Den här ändpunkten accepterar en multipart/form-data begäran för att ladda upp en ny videofil.
POST /uploads
Begärankropp (multipart/form-data)
| Fält | Typ | Krävs | Beskrivning |
|---|---|---|---|
video | file | Ja | Den video som ska laddas upp. |
mapp | string | Ja | Samlingssökvägen där videon ska placeras (t.ex., root/min-mapp). |
Exempelbegäran (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-din-api-nyckel-här
Content-Type: multipart/form-data; gräns=...
... (form data med fil och mapp) ...Svar: 202 Accepted
Den API bekräftar uppladdningen och returnerar det initiala statuset. Du bör spara id för att kontrollera statusen senare.
{
"meddelande": "Uppladdning accepterad och behandlas nu.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Hämta uppladdningsstatus
Hämtar statusen för de senast 50 uppladdningarna. Du kan polla den här ändpunkten för att uppdatera din UI.
GET /uploads
Exempelbegäran
GET /api/client/v1/uploads
Authorization: Bearer sk-din-api-nyckel-härSvar: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filnamn": "min_nya_video.mp4",
"status": 3,
"status_text": "processing",
"skapad_vid": "2024-08-11T10:00:00Z",
"uppdaterad_vid": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filnamn": "min_förra_video.mp4",
"status": 6,
"status_text": "completed",
"skapad_vid": "2024-08-10T15:00:00Z",
"uppdaterad_vid": "2024-08-10T15:05:00Z"
}
]
}Hämta en enskild uppladdningsstatus
Hämtar statusen för en specifik video baserat på dess ID.
GET /uploads/{videoId}
Exempelbegäran
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fSvar: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filnamn": "min_nya_video.mp4",
"status": 6,
"status_text": "completed"
}
}Statusreferens
| Statuskod | Statusbeskrivning | Beskrivning |
|---|---|---|
1 | pending | Uppladdningen är körd och väntar på att behandlas. |
3 | processing | Videon behandlas för närvarande. |
5 | uploading | Överförda filer överförs till slutlig lagring. |
6 | completed | Videon är fullständigt bearbetad och redo för spelning. |
7 | failed | Ett fel inträffade under behandlingen. |