Tautan Berbagi API

Endpoint ini memungkinkan Anda untuk menghasilkan tautan-tautan yang aman dan dapat diakses secara publik ke aset media Anda. Tautan-tautan ini dapat dilindungi kata sandi dan memiliki tanggal kedaluwarsa.

Buat Tautan Berbagi

POST /shareable-links

Endpoint ini menciptakan tautan unik untuk Video (VOD), Live Stream, atau Koleksi video.

Badan Permintaan

Bidang	Tipe	Diperlukan	Deskripsi
`media_id`	`string`	Ya	ID unik aset. Ini adalah UUID untuk video.
`media_type`	`string`	Ya	Tipe aset. Harus salah satu: `vod`, `live`, `collection`.
`visibility`	`string`	Ya	Tingkat akses. Harus salah satu: `public`, `password`.
`password`	`string`	Opsional	Diperlukan jika `visibility` adalah `password`. Minimal 6 karakter.
`expires_in_days`	`integer`	Opsional	Jumlah hari hingga tautan secara otomatis kedaluwarsa. Maksimal 365.

Contoh Permintaan

Untuk Video (VOD)


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

Untuk Koleksi


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

Tautan Dilindungi Kata Sandi


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

Contoh Respon: 201 Dibuat

Setelah sukses, API akan mengembalikan detail tautan yang dihasilkan.


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