공유 링크 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"
}