Videoiden Lataukset API
The Uploads API tarjoaa tavan suoraan ladata video-tiedostoja ja seurata niiden käsittelytilannetta.
Kaikki lataukset käsitellään asynkronisesti. Saat välittömän 202 Hyväksytty vastauksen, ja video käsitellään taustalla. Olitse käyttää tilannepisteitä seurata etenemistä.
Videon Lataaminen
Tämä päätepiste hyväksyy multipart/form-data -pyynnön ladata uusi video-tiedosto.
POST /uploads
Pyynnön Keskus ( multipart/form-data )
| Saha | Tyyppi | Vaaditaan | Kuvaus |
|---|---|---|---|
video | file | Kyllä | Laitettava video-tiedosto. |
folder | string | Kyllä | Kokoelma polku, johon video tulee sijoittua (esim., root/my-folderi). |
Esimerkki Pyynnön (.http)
POST /api/client/v1/uploads
Oikeudet: Bearer sk-asiakkaan api -avain-tässä
Content-Type: multipart/form-data; raja=...
... (muotoiltu tiedosto ja kansi) ...Vastaus: 202 Hyväksytty
The API vahvistaa latauksen ja palauttaa alku tilanne. Tallenna id tarkistaaksesi tilannetta myöhemmin.
{
"viesti": "Lataus hyväksytty ja on nyt käsiteltävänä.",
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"tilanne": 1,
"tilanteen teksti": "odottaa"
}
}Hae Latauksen Tila
Hakee viimeisten 50 latauksen tilan. Voit päivittää UI:siä tarkistamalla tämän päätepisteen.
GET /uploads
Esimerkki Pyynnön
GET /api/client/v1/uploads
Oikeudet: Bearer sk-asiakkaan api -avain-tässäVastaus: 200 OK
{
"data": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nimi": "uusi_video.mp4",
"tilanne": 3,
"tilanteen teksti": "käsittelee",
"luotu": "2024-08-11T10:00:00Z",
"päivitetty": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"nimi": "edellinen_video.mp4",
"tilanne": 6,
"tilanteen teksti": "valmis",
"luotu": "2024-08-10T15:00:00Z",
"päivitetty": "2024-08-10T15:05:00Z"
}
]
}Hae Yksittäisen Latauksen Tila
Hakee yksittäisen videon tilan sen ID:n perusteella.
GET /uploads/{videoId}
Esimerkki Pyynnön
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fVastaus: 200 OK
{
"data": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"nimi": "uusi_video.mp4",
"tilanne": 6,
"tilanteen teksti": "valmis"
}
}Tila Viite
| Tilakoodi | Tilanteen Teksti | Kuvaus |
|---|---|---|
1 | odottaa | Lataus on odotusaikana ja odottaa käsittelemistä. |
3 | käsittelee | Video on tällä hetkellä käsittelyssä. |
5 | ladataan | Käsitetty tiedostot siirretään lopulliseen tallennukseen. |
6 | valmis | Video on täysin käsitelty ja valmis näyttämiseen. |
7 | epäonnistui | Virhe tapahtui käsittelyssä. |