Liên kết Chia Sẻ API

Endpoints này cho phép bạn tạo ra các liên kết chia sẻ an toàn và công khai đến tài nguyên của mình. Các liên kết này có thể được bảo vệ bằng mật khẩu và có ngày hết hạn.

Tạo một Liên kết Chia Sẻ

POST /shareable-links

Endpoints này tạo ra một liên kết duy nhất cho một Video (VOD), một Live Stream hoặc một Bộ sưu tập các video.

Request Body

Trường	Loại	Yêu cầu	Mô tả
`media_id`	`string`	Có	ID duy nhất của tài nguyên. Đây là UUID cho videos.
`media_type`	`string`	Có	Loại tài nguyên. Phải là một trong: `vod`, `live`, `collection`.
`visibility`	`string`	Có	Mức độ truy cập. Phải là một trong: `public`, `password`.
`password`	`string`	Không bắt buộc	Yêu cầu nếu `visibility` là `password`. Tối thiểu 6 ký tự.
`expires_in_days`	`integer`	Không bắt buộc	Số ngày cho đến khi liên kết tự động hết hạn. Max 365.

Ví dụ Yêu Cầu

Để Video (VOD)


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

Để Bộ sưu tập


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

Bảo vệ bằng Mật Khẩu


{
    "media_id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "media_type": "live",
    "visibility": "password",
    "password": "mật-khẩu-bảo-mật"
}

Ví dụ Trả về: 201 Tạo Mới

Khi thành công, API sẽ trả về chi tiết liên kết được tạo.


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