Skip to Content
DocumentationAPI ReferenceVideodateien hochladen

Video-Uploads API

Der Upload-Service API bietet eine Möglichkeit, Videos direkt hochzuladen und ihren Verarbeitungsstatus zu überwachen.

Alle Uploads werden asynchron verarbeitet. Sie erhalten sofort einen 202 Accepted-Antwortcode und der Video wird im Hintergrund verarbeitet. Sie sollten die Statusendpunkte verwenden, um den Fortschritt zu überwachen.

Ein Video hochladen

Dieser Endpunkt akzeptiert ein multipart/form-data-Anfrage, um ein neues Video hochzuladen.

POST /uploads

Anforderungskörper (multipart/form-data)

FeldTypErforderlichBeschreibung
videofileJaDas zu ladende Video.
folderstringJaDer Pfad der Sammlung, in die das Video platziert werden soll (z.B. root/my-folder).

Beispielanfrage (.http)

POST /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-hier
Content-Type: multipart/form-data; boundary=...
 
... (Formdaten mit Datei und Ordner) ...

Antwort: 202 Accepted

Die API bestätigt den Upload und gibt den anfänglichen Status zurück. Sie sollten die id speichern, um den Status später abzufragen.

{
  "message": "Upload akzeptiert und wird jetzt verarbeitet.",
  "data": {
    "id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
    "status": 1,
    "status_text": "pending"
  }
}

Status eines Uploads abrufen

Ruft den Status der letzten 50 Uploads ab. Sie können diesen Endpunkt verwenden, um Ihren UI-Status zu aktualisieren.

GET /uploads

Beispielanfrage

GET /api/client/v1/uploads
Authorization: Bearer sk-your-api-key-hier

Antwort: 200 OK

{
  "data": [
    {
      "id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
      "filename": "my_new_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": "my_previous_video.mp4",
      "status": 6,
      "status_text": "completed",
      "created_at": "2024-08-10T15:00:00Z",
      "updated_at": "2024-08-10T15:05:00Z"
    }
  ]
}

Status eines einzelnen Uploads abrufen

Ruft den Status eines bestimmten Videos durch dessen ID ab.

GET /uploads/{videoId}

Beispielanfrage

GET /api/client/v1/uploads/9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f

Antwort: 200 OK

{
  "data": {
    "id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
    "filename": "my_new_video.mp4",
    "status": 6,
    "status_text": "completed"
  }
}

Statusbezug

StatuscodeStatusbeschreibungBeschreibung
1pendingDer Upload ist in der Warteschleife und wartet auf die Verarbeitung.
3processingDas Video wird derzeit transcodiert.
5uploadingDie transkodierten Dateien werden zum finalen Speicher hochgeladen.
6completedDas Video ist vollständig verarbeitet und bereit für die Wiedergabe.
7failedEin Fehler trat während der Verarbeitung auf.
LivestreamsTeilbare Links