Collegamenti condivisi API

Questo endpoint consente di generare in modo programmatico collegamenti sicuri e accessibili al pubblico per i tuoi asset multimediali. Questi collegamenti possono essere protetti da password e avere una data di scadenza.

Genera un Collegamento condiviso

POST /collegamenti-condivisi

Questo endpoint crea un link univoco per un singolo Video (VOD), un Flusso in diretta o una Raccolta di video.

Corpo della richiesta

Campo	Tipo	Richiesto	Descrizione
`media_id`	`string`	Sì	L’ID univoco dell’asset. Questo è un UUID per i video.
`media_type`	`string`	Sì	Il tipo di asset. Deve essere uno dei seguenti: `vod`, `live`, `collection`.
`visibility`	`string`	Sì	Livello di accesso. Deve essere uno dei seguenti: `public`, `password`.
`password`	`string`	Facoltativo	Richiesto se `visibility` è `password`. Minimo 6 caratteri.
`expires_in_days`	`integer`	Facoltativo	Il numero di giorni fino a quando il link automaticamente scade. Max 365.

Esempi di richiesta

Per un Video (VOD)


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

Per una Raccolta


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

Protetto da password


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

Esempio di Risposta: 201 Creato

Al successo, il API restituirà i dettagli del link generato.


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