Kanorio
Kanorio 개발자

비즈니스 시스템

보호된 결과물 및 학습 진도

권한 기반으로 보호되는 강의 및 다운로드 콘텐츠. 챕터, 레슨, 서명된 재생, 퀴즈, 진도 추적 및 수료증 기능을 제공합니다.

사용 가능

결과물(Deliverables)은 온라인 강의, 다운로드 가능한 파일, 멤버 전용 자료 등 고객이 액세스할 수 있는 디지털 콘텐츠를 의미합니다. Kanorio는 파일을 보호하고 여러 기기에서 각 학습자의 진도를 추적합니다.

주요 객체

  • 결과물(Deliverables): 강의나 다운로드 팩으로, 해당 콘텐츠에 대한 액세스 권한을 부여하는 제품과 연결됩니다.
  • 단원(Units): 챕터와 레슨으로, 동영상, 오디오, PDF, 텍스트, 파일, 임베드 콘텐츠, 퀴즈 등이 포함됩니다. 강의는 레슨을 순서대로 수강하도록 설정할 수 있으며, 특정 레슨을 관문(gate)으로 지정할 수 있습니다.
  • 진도(Progress): 각 학습자가 학습을 중단한 지점, 완료한 레슨, 강의 수료 시점 등을 기록합니다.
  • 수료증(Certificates): 수료증 발행이 설정된 강의를 학습자가 완료하면 생성됩니다.

API 활용 방법

  • Management API를 사용하여 강의를 구성 및 수정하고, 자체 보고서를 위해 학습자의 진도 데이터를 읽어올 수 있습니다.
  • 학습자는 로그인 후 단기 서명된 URL을 통해 레슨을 열고, 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
전체 변경 내역 보기

사이트 운영자용

관리 화면에서 이 제품을 사용하는 방법은 도움말 센터에서 안내합니다.

도움말 센터 열기