用途:通过 ibl.ai Course Creation API 以编程方式生成、编辑和发布课程。典型流程为:创建任务 → 用 AI 生成大纲 → 启动完整创建流程 → 读取完整结构或草稿内容。
认证与约定:基础地址为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量:{org}=$IBLAI_ORG,{username}=$IBLAI_USERNAME,{task_id} 为课程创建任务 id,{course_id} 为已创建课程 id。所有端点的主机根路径为 …/dm/api/ai-mentor/orgs/{org}/users/{username}/course-creation/。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取接口:任务方面,GET …/course-creation/tasks/ 列出任务,GET …/tasks/{task_id}/ 查看任务详情与状态(状态流转为 Pending → Scheduled),GET …/tasks/{task_id}/start/ 启动完整创建流程,GET …/tasks/{task_id}/cancel/ 取消流程。课程方面,GET …/course-creation/course/ 列出课程(可用 ?task={task_id} 按任务过滤),GET …/course/{course_id}/ 查看课程详情,GET …/course/{course_id}/outline/ 获取大纲(不含组件内容),GET …/course/{course_id}/full-structure/ 获取完整结构(加 ?include_content=true 可含 HTML),GET …/course/{course_id}/draft-content-for-all-units/ 获取所有单元的草稿内容。
写入接口:POST …/course-creation/tasks/ 创建任务;DELETE …/tasks/{task_id}/ 删除任务(破坏性操作,需先与用户确认);POST …/tasks/{task_id}/create-course/ 在 LMS 上创建课程;POST …/tasks/{task_id}/create-course-outline/ 用 AI 生成大纲;DELETE …/course/{course_id}/ 删除课程记录(破坏性操作,需先确认);POST …/course/{course_id}/draft-content-for-unit/ 为单个单元生成草稿内容。
示例:为已有任务生成 AI 大纲:curl -X POST "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/course-creation/tasks/$TASK_ID/create-course-outline/" -H "Authorization: Api-Token $IBLAI_API_KEY"。
限制与说明:任务状态为 Pending → Scheduled,可轮询 …/tasks/{task_id}/ 跟踪进度,用 …/tasks/{task_id}/cancel/ 停止运行中的流程;full-structure/ 默认不返回 HTML,需加 ?include_content=true 才包含渲染后的组件内容。删除类接口具有破坏性,执行前应确认。其余如计费、平台支持范围等资料暂未提供。