Delingbare Links API

Dit eindpunt maakt het mogelijk om veilige, openbare links te genereren naar je media assets. Deze links kunnen wachtwoordbescherming hebben en een vervaldatum.

Een Delingbare Link Genereren

POST /shareable-links

Dit eindpunt creëert een unieke link voor een enkel Video (VOD), een Live Stream of een Collectie van video’s.

Verzoek Lichaam

Veld	Type	Vereist	Beschrijving
`media_id`	`string`	Ja	De unieke ID van het asset. Dit is een UUID voor videos.
`media_type`	`string`	Ja	Het type asset. Moet één van: `vod`, `live`, `collection` zijn.
`visibility`	`string`	Ja	De toegangs niveau. Moet één van: `public`, `password` zijn.
`password`	`string`	Optioneel	Vereist als `visibility` is `password`. Minimum 6 tekens.
`expires_in_days`	`integer`	Optioneel	Het aantal dagen tot de link automatisch verloopt. Max 365.

Voorbeeld Verzoeken

Voor een Video (VOD)


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

Voor een Collectie


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

Wachtwoordbescherming


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

Voorbeeld Antwoord: 201 Created

Bij succes zal de API het gegenereerde link details retourneren.


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