Linki udostępnione API

Ten punkt końcowy pozwala na programową generację bezpiecznych, publicznie dostępnych linków do Twoich zasobów medialnych. Te linki mogą być chronione hasłem i mogą mieć datę wygaśnięcia.

Generuj link udostępniony

POST /shareable-links

Ten punkt końcowy tworzy unikalny link dla pojedynczego filmu (VOD), transmisji na żywo lub kolekcji filmów.

Ciało żądania

Pola	Typ	Wymagane	Opis
`media_id`	`string`	Tak	Unikalny ID zasobu. To jest UUID dla filmów.
`media_type`	`string`	Tak	Rodzaj zasobu. Musi być jednym z: `vod`, `live`, `collection`.
`visibility`	`string`	Tak	Poziom dostępu. Musi być jednym z: `public`, `password`.
`password`	`string`	Opcjonalnie	Wymagane, jeśli `visibility` jest `password`. Minimum 6 znaków.
`expires_in_days`	`integer`	Opcjonalne	Liczba dni do momentu automatycznego wygaśnięcia linku. Maksimum 365.

Przykładowe żądania

Dla filmu (VOD)


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

Dla kolekcji


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

Chroniony hasłem


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

Przykładowy odpowiedź: 201 Utworzono

Po sukcesie API zwróci szczegóły utworzonego linku.


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