Delbara Länkar API

Denna endpoint tillåter dig att programmässigt generera säkra och offentliga länkar till dina medieobjekt. Dessa länkar kan skyddas med ett lösenord och kan ha en giltighetstid.

Generera en Delbar Länk

POST /shareable-links

Denna endpoint skapar en unik länk för ett enda Video (VOD), en Live Stream eller en Samling av videor.

Begäran Body

Fält	Typ	Krävs	Beskrivning
`media_id`	`string`	Ja	Den unika ID:t för objektet. Detta är en UUID för videor.
`media_type`	`string`	Ja	Typen av objekt. Måste vara ett av: `vod`, `live`, `collection`.
`visibility`	`string`	Ja	Åtkomstnivån. Måste vara ett av: `public`, `password`.
`password`	`string`	Valfritt	Krävs om `visibility` är `password`. Minst 6 tecken.
`expires_in_days`	`integer`	Valfritt	Antalet dagar tills länken automatiskt upphör att gälla. Max 365.

Exempelbegäran

För en Video (VOD)


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

För en Samling


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

Lösenordskyddad


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

Exempel Svar: 201 Skapad

När begäran lyckas kommer API att returnera de genererade länk detaljerna.


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