商業系統
受保護的交付內容與進度
由權限保護的課程與下載內容,包含章節與課程、簽章播放、測驗、進度追蹤與證書。
交付內容(Deliverables)是客戶可存取的數位內容:線上課程、可下載檔案與會員專屬素材。Kanorio 會保護這些檔案,並追蹤每位學員在不同裝置上的學習進度。
核心物件
- 交付內容(Deliverables)。 課程或下載包,連結至授予存取權的產品。
- 單元(Units)。 章節與課程:影片、音訊、PDF、文字、檔案、嵌入內容與測驗。課程可要求依序完成課程,且任何課程皆可作為關卡。
- 進度(Progress)。 記錄每位學員的學習中斷點、已完成的課程,以及課程完成時間。
- 證書(Certificates)。 當學員完成設有證書的課程時自動產生。
API 如何運作
- 使用 Management API 建立與編輯課程,並讀取學員進度以製作您自己的報表。
- 學員登入後,透過短效簽章網址(signed URLs)開啟課程,並透過 Customer API 回報進度與進行測驗。
<kanorio-curriculum>與<kanorio-unit>提供課程大綱與完整的課程檢視畫面。- Webhooks 會回報已完成的課程、測驗嘗試次數與已發放的證書。
課程與會員指南將引導您完成完整的整合流程。
API 開放的範圍
- Deliverables (courses, downloads)可用
- API
- Management API
deliverables.*,deliverable_units.*; DeliveryGET /products/:slugoutline; CustomerGET /deliverables,GET /deliverables/:deliverableId - Elements
<kanorio-curriculum>(public outline, free previews)- 託管網站
/deliverables,/data/deliverables,/data/deliverable_units; productcontent-curriculumsection
- Protected playback & downloads可用
- API
- Customer
POST /units/:id/open(signed URL valid for 600 s; videos are signed for their length); DeliveryPOST /units/:id/openfor previews - Elements
<kanorio-unit>(video, audio, PDF, text, files, embeds)- 託管網站
/account/content/:deliverableId
- Progress & completion可用
- API
- Customer
POST /progress,POST /units/:id/quiz,GET /deliverables/:deliverableId/progress,GET /deliverables/:deliverableId/certificate(PDF rendered on download from current settings and branding); Management APIprogress.list,progress.reset,progress.complete,deliverables.certificate_preview - Elements
<kanorio-unit>reports progress automatically;kanorio:progressevent- 託管網站
/data/progress;/account/contentprogress bars- Webhooks
deliverables.progress.completed,deliverables.progress.unit_completed,deliverables.quiz.attempted,deliverables.certificate.issued
API 參考
Webhook 事件
- deliverables.progress.completed · Fired once when a learner first meets the deliverable's completion rule (completion snapshot; never fires again for that learner even if units are added later).
- deliverables.progress.unit_completed · Fired when a learner completes one unit (video/audio watched to 90%, or marked complete). Use it for per-chapter automations.
- deliverables.progress.stalled · Fired by the daily check when a learner stalls: granted access 14+ days ago and never started (not_started), or has progress but no activity for 7+ days (inactive). At most once per learner, deliverable and reason per ISO week. Use it for reminder automations.
- deliverables.quiz.attempted · Fired for every graded quiz attempt (score 0–100, passed, attemptNo). A passed attempt also completes the unit.
- deliverables.certificate.issued · Fired when a completion certificate is issued (serial); the PDF is fetched through the Customer API.
Elements
- <kanorio-unit> · Protected player with an outline sidebar for video, audio, PDF, text, file and embed units, locked and not-yet-released states, and automatic progress reporting.
- <kanorio-curriculum> · Public outline for a product: chapters, units, durations and free previews that play without signing in.
指南
近期變更
- 2026-11-04 Localization: more translatable fields (product details, variants, lessons, quizzes, store notes)
- 2026-11-04 Products: access duration is set per variant
- 2026-11-03 Customer API: course, unit and order text in the customer's locale
- 2026-11-02 Deliverables: units no longer have plan scope
- 2026-11-02 Deliverables: certificate background image
給網站擁有者
在後台如何使用這項產品,請見說明中心。
開啟說明中心