Video Oppdateringer API
Oppdateringsprosessen API gir muligheten til å laste opp videoer direkte og overvåke deres behandlingsstatus.
Alle oppdateringer prosesseres asynkront. Du vil få en umiddelbar 202 Accepted respons, og videoen vil bli behandlet i bakgrunnen. Du bør bruke status-endepunkter for å overvåke fremgang.
Last Opp En Video
Dette endepunktet aksepterer et multipart/form-data- forespørsel til å laste opp en ny videofil.
POST /oppdateringer
Forespørselskropp (multipart/form-data)
| Felt | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
video | file | Ja | Den videoen som skal lastes opp. |
mappe | string | Ja | Samlingssøppelstien hvor videoen skal plasseres (f.eks., root/minne-mappe). |
Eksempel Forespørsel (.http)
POST /api/klient/v1/oppdateringer
Autorisasjon: Bearer sk-din-api-nøkkel-here
Content-Type: multipart/form-data; grense=...
... (form data med fil og mappe) ...Respons: 202 Acceptert
Oppdateringsprosessen API bekrefter oppdateringen og returnerer den innledende status. Du bør lagre id for å sjekke status senere.
{
"beskjed": "Oppdatering acceptert og er nå i gang med å bli behandlet.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Hent Oppdateringer Status
Henter statusen på de 50 siste oppdateringene. Du kan poll denne endepunktet for å oppdatere din UI.
GET /oppdateringer
Eksempel Forespørsel
GET /api/klient/v1/oppdateringer
Autorisasjon: Bearer sk-din-api-nøkkel-hereRespons: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filnavn": "min nye video.mp4",
"status": 3,
"status_text": "behandling",
"opprettet": "2024-08-11T10:00:00Z",
"oppdatert": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"filnavn": "min tidligere video.mp4",
"status": 6,
"status_text": "fullført",
"opprettet": "2024-08-10T15:00:00Z",
"oppdatert": "2024-08-10T15:05:00Z"
}
]
}Hent Enkelt Oppdatering Status
Henter statusen på en spesifik video ved hjelp av dens ID.
GET /oppdateringer/{videoId}
Eksempel Forespørsel
GET /api/klient/v1/oppdateringer/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fRespons: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"filnavn": "min nye video.mp4",
"status": 6,
"status_text": "fullført"
}
}Statusreferanse
| Statuskode | Status tekst | Beskrivelse |
|---|---|---|
1 | pending | Oppdateringen er i kø og ventar på å bli behandlet. |
3 | behandling | Videoen blir nå behandlet. |
5 | laste opp | Transkoderte filer lastes opp til endelig lagring. |
6 | fullført | Videoen er fullstendig behandlet og klar for spill. |
7 | feil | En feil skjedde under behandling. |