シェア可能なリンク API
このエンドポイントでは、プログラム的に安全で公開向けのリンクを生成できます。これらのリンクはパスワード保護が可能であり、有効期限も設定できます。
シェア可能なリンクを作成する
POST /shareable-links
このエンドポイントでは、単一のビデオ (VOD)、ライブ ストリーム、またはビデオのコレクションに一意のリンクを生成します。
リクエスト ボディー
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
media_id | string | Yes | アセットのユニーク ID。このビデオの場合、UUID です。 |
media_type | string | Yes | アセットのタイプ。vod、live、または collection のいずれかでなければなりません。 |
visibility | string | Yes | アクセス レベル。public または password のいずれかでなければなりません。 |
password | string | Optional | visibility が password の場合、必須です。最小 6 文字。 |
expires_in_days | integer | Optional | リンクが自動的に有効期限切れになるまでの日数。最大 365 日。 |
例リクエスト
ビデオ (VOD) に対して
{
"media_id": "9c1a9e3e-6c9b-4f8a-8e2d-9b3c1d4e0f6a",
"media_type": "vod",
"visibility": "public",
"expires_in_days": 7
}例レスポンス: 201 Created
成功すると、API が生成されたリンクの詳細を返します。
{
"link": "https://your-app.com/s/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
"token": "aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
"visibility": "public",
"expires_at": "2025-08-17T14:30:00Z"
}