Video Uploads API
Upload af videoer giver mulighed for direkte oploadning af videofiler og overvågning af deres processtatus.
Alle oploadninger behandles asynkront. Du vil modtage en umiddelbar 202 Accepted respons, og videoen vil blive behandlet i baggrunden. Du skal bruge status-endpunkterne til at overvåge fremgang.
Upload af Video
Dette endpoint accepterer et multipart/form-data anmodning til oploadning af en ny videofil.
POST /uploads
Anmodningskrop (multipart/form-data)
| Felt | Type | Kræves | Beskrivelse |
|---|---|---|---|
video | file | Ja | Den videofil, der skal oploades. |
mappe | string | Ja | Samlingensti, hvor videoen skal placeres (f.eks. root/min-mappe). |
Eksempelanmodning (.http)
POST /api/client/v1/uploads
Authorization: Bearer sk-din-api-nøgle-here
Content-Type: multipart/form-data; boundary=...
... (form data med fil og mappe) ...Svar: 202 Accepted
Uploaden bekræfter oploadningen og returnerer den inledende status. Du skal gemme id for at tjekke statussen senere.
{
"besked": "Upload accepteret og er nu i gang med at blive behandlet.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Hent Uploads Status
Henter status for de sidst 50 oploadninger. Du kan poll denne endpoint til at opdatere din UI.
GET /uploads
Eksempelanmodning
GET /api/client/v1/uploads
Authorization: Bearer sk-din-api-nøgle-hereSvar: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "min_nye_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": "min_forrige_video.mp4",
"status": 6,
"status_text": "completed",
"created_at": "2024-08-10T15:00:00Z",
"updated_at": "2024-08-10T15:05:00Z"
}
]
}Hent Enkelt Upload Status
Henter status for en bestemt video ved dens ID.
GET /uploads/{videoId}
Eksempelanmodning
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fSvar: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filename": "min_nye_video.mp4",
"status": 6,
"status_text": "completed"
}
}Statusreferencen
| Statuskode | Status tekst | Beskrivelse |
|---|---|---|
1 | pending | Uploaden er i kø og ventende på at blive behandlet. |
3 | processing | Videoen er i gang med at blive omformet. |
5 | uploading | Omformerne filer bliver oploadet til endelig lagring. |
6 | completed | Videoen er fuldt behandlet og klar til afspilning. |
7 | failed | En fejl opstod under behandlingen. |