Video Uploads API
De Uploads API biedt een manier om video-bestanden rechtstreeks te uploaden en hun verwerkingstatus te controleren.
Alle uploads worden asynchroon verwerkt. U ontvangt direct een 202 Accepted-antwoord, en de video wordt in de achtergrond verwerkt. Gebruik de status-eindpunten om de voortgang te controleren.
Een Video Uploaden
Dit eindpunt accepteert een multipart/form-data-verzoek om een nieuwe video-bestand te uploaden.
POST /uploads
Verzoek lichaam (multipart/form-data)
| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
video | file | Ja | Het video-bestand dat moet worden geüpload. |
map | string | Ja | De collectiepad waar het video-bestand moet worden geplaatst (bijv., root/my-map). |
Voorbeeldverzoek (.http)
POST /api/client/v1/uploads
Autorisatie: Bearer sk-uw-api-sleutel-hier
Content-Type: multipart/form-data; grens=...
... (formuliergegevens met bestand en map) ...Antwoord: 202 Accepted
Het API bevestigt de upload en retourneert de initiële status. Bewaar het id om later de status te controleren.
{
"bericht": "Upload is geaccepteerd en wordt nu verwerkt.",
"gegevens": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"status": 1,
"status_text": "pending"
}
}Uploads Status Ophalen
Haalt de status van de 50 meest recente uploads op. U kunt deze eindpunt gebruiken om uw UI bij te werken.
GET /uploads
Voorbeeldverzoek
GET /api/client/v1/uploads
Autorisatie: Bearer sk-uw-api-sleutel-hierAntwoord: 200 OK
{
"gegevens": [
{
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"bestandsnaam": "mijn_nieuwe_video.mp4",
"status": 3,
"status_text": "verwerking",
"gemaakt_op": "2024-08-11T10:00:00Z",
"bijgewerkt_op": "2024-08-11T10:01:00Z"
},
{
"id": "9c1fa5c3-b9f2-5c3f-8e7f-2d9b1c4e1f8e",
"bestandsnaam": "mijn_vorige_video.mp4",
"status": 6,
"status_text": "afgerond",
"gemaakt_op": "2024-08-10T15:00:00Z",
"bijgewerkt_op": "2024-08-10T15:05:00Z"
}
]
}Status van een Enkele Upload Ophalen
Haalt de status van één specifieke video op door zijn ID.
GET /uploads/{videoId}
Voorbeeldverzoek
GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7fAntwoord: 200 OK
{
"gegevens": {
"id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
"bestandsnaam": "mijn_nieuwe_video.mp4",
"status": 6,
"status_text": "afgerond"
}
}Statusreferentie
| Statuscode | Status tekst | Beschrijving |
|---|---|---|
1 | pending | De upload is geplaatst en wacht op verwerking. |
3 | verwerking | Het video-bestand wordt momenteel verwerkt. |
5 | uploaden | De verwerkte bestanden worden naar de eindopslag geüpload. |
6 | afgerond | Het video-bestand is volledig verwerkt en klaar voor afspelen. |
7 | gefaald | Er is een fout opgetreden tijdens de verwerking. |