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
查看完整更新日志

给网站所有者

如何在后台使用这项产品,请参阅帮助中心。

打开帮助中心