Teilebare Links API

Dieser Endpunkt ermöglicht Ihnen die programmatische Erstellung sicherer, öffentlicher Links zu Ihren Medienassets. Diese Links können mit einem Passwort geschützt und mit einer Ablaufzeit versehen werden.

Eine Teilebare Link erstellen

POST /shareable-links

Dieser Endpunkt erstellt eine eindeutige Link für einen einzelnen Video (VOD), einen Live-Stream oder eine Sammlung von Videos.

Anforderungsbody

Feld	Typ	Erforderlich	Beschreibung
`media_id`	`string`	Ja	Die eindeutige ID des Assets. Dies ist ein UUID für Videos.
`media_type`	`string`	Ja	Der Typ des Assets. Muss einer der folgenden sein: `vod`, `live`, `collection`.
`visibility`	`string`	Ja	Der Zugriffsebene. Muss einer der folgenden sein: `public`, `password`.
`password`	`string`	Optional	Erforderlich, wenn `visibility` `password` ist. Mindestens 6 Zeichen.
`expires_in_days`	`integer`	Optional	Die Anzahl der Tage, bis der Link automatisch abläuft. Maximal 365.

Beispielanfragen

Für ein Video (VOD)


{
    "media_id": "9c1a9e3e-6c9b-4f8a-8e2d-9b3c1d4e0f6a",
    "media_type": "vod",
    "visibility": "public",
    "expires_in_days": 7
}

Für eine Sammlung


{
    "media_id": "42",
    "media_type": "collection",
    "visibility": "public"
}

Passwort geschützt


{
    "media_id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "media_type": "live",
    "visibility": "password",
    "password": "super-secret-password"
}

Beispielantwort: 201 Erstellt

Bei Erfolg wird der API die generierte Linkdetails zurückgeben.


{
  "link": "https://your-app.com/s/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "token": "aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "visibility": "public",
  "expires_at": "2025-08-17T14:30:00Z"
}