Legături Partajabile API

Această endpoint permite generarea programatică a legăturilor publice și securizate către resursele tale de media. Aceste legături pot fi protejate cu parolă și pot avea o dată de expirare.

Generează o Legătură Partajabilă

POST /shareable-links

Această endpoint creează o legătură unică pentru un singur Video (VOD), un Live Stream sau o Colecție de videoclipuri.

Corpul Cererii

Câmp	Tip	Reținut	Descriere
`media_id`	`string`	Da	ID-ul unic al resursei. Acesta este un UUID pentru videoclipuri.
`media_type`	`string`	Da	Tipul resursei. Trebuie să fie una dintre: `vod`, `live`, `collection`.
`visibility`	`string`	Da	Nivelul de acces. Trebuie să fie una dintre: `public`, `password`.
`password`	`string`	Optional	Reținut dacă `visibility` este `password`. Minim 6 caractere.
`expires_in_days`	`integer`	Optional	Numărul de zile până la expirarea automată a legăturii. Max 365.

Exemple de Cereri

Pentru un Video (VOD)


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

Pentru o Colecție


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

Protejată cu Parolă


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

Exemplu de Răspuns: 201 Created

La reușită, API va returna detalii despre legătura generată.


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