Kanorio

商業系統

受保護的交付內容與進度

由權限保護的課程與下載內容,包含章節與課程、簽章播放、測驗、進度追蹤與證書。

可用

交付內容(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.*; Delivery GET /products/:slug outline; Customer GET /deliverables, GET /deliverables/:deliverableId
    Elements
    <kanorio-curriculum> (public outline, free previews)
    託管網站
    /deliverables, /data/deliverables, /data/deliverable_units; product content-curriculum section
  • Protected playback & downloads可用
    API
    Customer POST /units/:id/open (signed URL valid for 600 s; videos are signed for their length); Delivery POST /units/:id/open for 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 API progress.list, progress.reset, progress.complete, deliverables.certificate_preview
    Elements
    <kanorio-unit> reports progress automatically; kanorio:progress event
    託管網站
    /data/progress; /account/content progress 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
查看完整變更紀錄

給網站擁有者

在後台如何使用這項產品,請見說明中心。

開啟說明中心