Делението на свързани връзки API

Този ендпоинт позволява програмирано създаване на сигурни и достъпни за обществеността връзки към вашите медийни ресурси. Връзките могат да бъдат защитени с парола и да има експирайна дата.

Създаване на свързана връзка

POST /shareable-links

Този ендпоинт създава уникална връзка за един Video (VOD), Live Stream или Колекция от видеа.

Телото на заявката

Поле	Тип	Обязателен	Описание
`media_id`	`string`	Да	Уникалният ID на ресурса. Това е UUID за видеата.
`media_type`	`string`	Да	Типът на ресурса. Допустими стойности са: `vod`, `live`, `collection`.
`visibility`	`string`	Да	Нивото на достъпност. Допустими стойности са: `public`, `password`.
`password`	`string`	Необязателен	Трябва да бъде зададен, ако `visibility` е `password`. Минимум 6 символа.
`expires_in_days`	`integer`	Необязателен	Броят на дните до връзката автоматично изтича. Максимум 365.

Примерни заявки

За видео (VOD)


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

За Колекция


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

С защитена парола


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

Примерна отговор: 201 Created

При успех API ще върне детайлите за създадената връзка.


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