商业系统
受保护的交付内容与进度
由权限保护的课程与下载内容,包含章节与课程、签名播放、测验、进度追踪及证书。
交付内容(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
给网站所有者
如何在后台使用这项产品,请参阅帮助中心。
打开帮助中心