SuperAPI AI 工具集

iblai-api-milestone

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 数据管理器(DM)API 读写组织目录的里程碑数据,包括课程、资源、项目、路径的完成记录,以及技能点。适用于查询或写入用户学习进度和技能点统计。

连接与认证:基础 URL 为 https://api.iblai.app/dm,所有端点需带 /dm 前缀。请求头为 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 对应 $IBLAI_ORG(即 platform_key),{username} 对应 $IBLAI_USERNAME。若尚未连接,先执行 /iblai-api-login 以填充上述环境变量。DELETE 为破坏性操作,执行前须向用户确认。

读取能力:课程完成支持单条查询(参数 course_id、user_id)与单用户目录全量查询(参数 user_id,可选 field_key);资源完成按 resource_id、user_id 查询;项目完成需 program_key(必填,需 URL 编码)加 user_id 或 username,返回 count 与 0.0–1.0 的 completion_percentage;路径完成需 pathway_uuid 加 user_id 或 username,返回格式同上。技能点方面,可按 block_id 或 course_id 查询 {skill: points} 映射;平台级查询需 platform_key(或 platform_org),支持分页;用户级返回 {skill: {course_points, block_points, platform_points, total_points}}。

写入能力:课程完成、资源完成通过对应 manage 端点新增或更新;技能点可设置 block、course 级别,平台级支持单用户更新、DELETE 删除与 bulk 批量更新(需平台管理员权限)及 group 组更新。平台/批量/组更新中的 overwrite 默认 true,表示替换原有技能点,设为 false 则合并累加。

限制:id 为不透明键(如 course-v1:...、block-v1:...、program-v1:...),查询字符串中须 URL 编码;platform_key 在技能点操作中即组织键;平台批量更新需平台管理员权限。资料未提供定价、速率限制及更多错误处理细节。