用途:通过 ibl.ai 平台 API 管理组织的学习目录,包括课程、项目(programs)、路径(pathways)、资源,以及技能与角色分类(含用户期望/已报告技能与角色)、课程与项目元数据、报名(课程/项目/路径,管理员与自助)、资格校验、目录搜索和课程评价。
主要能力:读取课程、项目、路径、资源及其元数据与公开元数据;查询技能、角色及用户期望/已报告数据;检查用户可修读的课程与单课程资格;搜索课程/项目/路径报名;获取下一门推荐课程;管理课程与项目评价及聚合评分。写入方面支持创建/更新课程、项目、路径、资源、元数据、技能、角色、报名与评价,以及删除相应对象。
使用方式:基础地址为 https://api.iblai.app/dm,所有路径需带 /dm 前缀,例如 https://api.iblai.app/dm/api/catalog/courses/。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。{org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME,org/user 通过查询参数或请求体传递,不写入路径。course_id 在查询字符串中必须 URL 编码。未连接时先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
适用场景:填充学习目录、为用户报名、判断谁可修读哪些内容、维护技能/角色图谱、检索与评价课程和项目。
限制:DELETE、破坏性或对外调用需先与用户确认;部分接口要求特定参数(如项目报名需用户标识,缺失会返回 400);字段路径 POST 不支持(返回 404);公开元数据接口无需认证且只读;技能/角色公开创建受配置开关限制。具体收费、价格与平台支持范围暂未提供。