媒體與資產

網站使用的每一張圖片、影片與檔案皆存放於媒體庫中。內容透過資產 ID 參照檔案，API 回應會將 ID 解析為 URL、尺寸、替代文字與預留位置。

核心物件

• 資產 (Assets)： 包含檔案的可見性、標籤、替代文字、焦點與處理狀態。公開檔案透過 CDN 傳輸。受保護的檔案（如課程影片）僅能透過短效簽章 URL 存取。
• 圖片變體 (Image variants)： 按需調整大小的版本，以及每張圖片的微型模糊預留位置。
• 影片串流 (Video streaming)： 影片會轉換為自適應串流，受保護的影片則會使用簽章片段。

API 如何運作

• 透過 Management API 使用 URL 或檔案上傳、請求大型檔案的直接上傳 URL、建立客戶端上傳連結，以及匯入庫存照片。
• 每個參照媒體的 Content Delivery API 回應皆包含 assets 對應表。
• 使用 <kanorio-media> 與 <kanorio-lightbox> 播放媒體與顯示圖片。
• Webhooks 會回報資產處理完成或失敗的狀態。