Skip to Content
DocumentationAPI ReferenceNahrávání videa

Video Uploads API

The Uploads API poskytuje možnost přímého nahrávání videa a sledování stavu zpracování.

Všechny nahrávky jsou zpracovávány asynchronně. Získáte okamžitou odpověď 202 Accepted a video bude zpracováno v pozadí. Měli byste použít koncovky statusu k monitorování pokroku.

Nahrání videa

Tento koncový bod přijímá požadavek multipart/form-data pro nahrání nového souboru videa.

POST /uploads

Tělo požadavku (multipart/form-data)

PoleTypPovinnéPopis
videofileAnoSoubor videa k nahrání.
folderstringAnoCesta kolekce, kde by měl být soubor umístěn (například root/moje-složka).

Příklad požadavku (.http)

POST /api/client/v1/uploads
Authorization: Bearer sk-váš-api-klíč-zde
Content-Type: multipart/form-data; boundary=...
 
... (form data souborem a složkou) ...

Odpověď: 202 Accepted

Koncovka API potvrzuje nahrání a vrátí počáteční stav. Měli byste uložit id pro pozdější kontrolu stavu.

{
  "message": "Nahrání bylo přijato a je nyní zpracováváno.",
  "data": {
    "id": "9c1fa5c4-a8f1-4b2e-9d6e-1c8a0b9e2d7f",
    "status": 1,
    "status_text": "pending"
  }
}

Získání stavu nahrávek

Získá stav posledních 50 nahrávek. Můžete použít tento koncový bod k aktualizaci vaší UI.

GET /uploads

Příklad požadavku

GET /api/client/v1/uploads
Authorization: Bearer sk-váš-api-klíč-zde

Odpověď: 200 OK

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

Získání stavu jedné nahrávky

Získá stav jedné konkrétní video podle jeho ID.

GET /uploads/{videoId}

Příklad požadavku

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

Odpověď: 200 OK

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

Reference stavu

Kód statusuText statusuPopis
1pendingNahrávka je v pořadí a čeká na zpracování.
3processingVideo se aktuálně zpracovává.
5uploadingPřekódované soubory jsou nahrávány do konečné úložiště.
6completedVideo je plně zpracováno a připraveno k přehrávání.
7failedDošlo k chybě během zpracování.
Živé přenosySdílené odkazy