SuperAPI AI 工具集

iblai-api-milestone

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:查询或记录 ibl.ai 组织中用户的进度与技能点总数,覆盖课程、资源、项目、路径的完成记录及技能点读写。

主要能力:读取单门课程完成、某用户全部课程完成、单项资源完成、用户项目与路径完成(返回 count 与 0.0–1.0 的 completion_percentage);读取块、课程、平台与用户技能点,用户技能点按 course_points、block_points、platform_points、total_points 聚合。写入课程与资源完成记录,设置块/课程技能点,更新用户平台技能点,并支持批量与分组更新。

使用方式:基础地址为 https://api.iblai.app/dm,路径前缀 /dm 必填;每个请求带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG(即 platform_key),{username}=$IBLAI_USERNAME。未连接时先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。查询示例:curl -G "https://api.iblai.app/dm/api/catalog/milestones/completions/course/manage/" -H "Authorization: Api-Token $IBLAI_API_KEY" --data-urlencode "course_id=course-v1:edX+DemoX+Demo_Course" --data-urlencode "user_id=10"。

限制:DELETE 为破坏性操作,需先与用户确认;平台批量更新需平台管理员权限;overwrite 默认 true,设为 false 则合并/累加;platform_key 在技能点操作中即 org key;ID 格式为不透明键(如 course-v1:edX+DemoX+Demo_Course、block-v1:test+test+test+type@html+block@<hash>、program-v1:main+test),路径使用 UUID,查询字符串中需 URL 编码(: → %3A,+ → %2B,@ → %40)。