用途:通过 ibl.ai 平台 API 读写组织的目录里程碑,包括课程、资源、项目、路径的完成记录,以及技能点数据,适用于查询或记录学习者进度与技能点总分。
主要能力:读取课程、资源、项目、路径的完成情况(含完成百分比、完成日期、评分字段等);读取区块、课程、平台、用户维度的技能点;写入或更新课程与资源完成记录;设置区块、课程技能点;更新用户平台技能点,并支持批量与分组更新。
使用方式:基础地址为 https://api.iblai.app/dm,所有请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 对应 $IBLAI_ORG(即 platform_key),{username} 对应 $IBLAI_USERNAME。未连接时先运行 /iblai-login 填充这些变量。示例: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 为破坏性操作,需先与用户确认。课程 ID、区块 ID、项目键、路径 UUID 等需在查询字符串中 URL 编码(: → %3A,+ → %2B,@ → %40)。平台批量更新需要平台管理员权限。overwrite 默认 true,会替换用户已有技能点,设为 false 则合并累加。