可分享的链接 API

这个端点允许您程序化地生成安全、面向公众的链接来访问您的媒体资产。这些链接可以被密码保护，并且可以设置过期日期。

生成可分享的链接

POST /shareable-links

这个端点为单个视频（VOD）、直播或视频集合创建一个唯一的链接。

请求体

字段	类型	必须	描述
`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"
}