用途:通过 ibl.ai 平台 API 管理组织的数字凭证与证书,包括创建/编辑凭证、分配给用户或群组、读取已签发凭证(assertions)、在课程间导入导出课程级凭证、配置 Accredible 等外部签发方及凭证到外部模板的映射,并拉取签发量随时间变化的统计。
必要用法:基础地址为 https://api.iblai.app/dm,Data Manager 端点必须带 /dm 前缀。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org}=$IBLAI_ORG(即 platform_key,回退到 Platform.org,也可作 platform_org 查询参数),用户段可接受数字 {user_id} 或 {username},{course_id} 为 Open edX 课程 id(如 course-v1:org+course+run)。凭证、assertions、assignments 的详情端点只按 entity_id(UUID 字符串)查询,不接受数字数据库 id。响应统一为 {"status": {"success": bool, "description": str}, "result": {…}} 包裹;分页列表 result 带 count、next、previous 及 results 或 data。列表支持 page、page_size(默认 10,最大 100;provider/mapping 列表默认 50,最大 1000)和 search。未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
主要能力:凭证 CRUD(创建需 name 与 issuer 即签发方 entity_id,signal 默认 COURSE_PASSED;删除时若仍有有效 assertions 返回 409);签发方与署名管理;用户/群组分配(群组分配异步处理,分配后产生 assertions);assertion 撤销与单个/批量签发;公开的 assertion 查询与 provider 列表;课程凭证导出(DM 管理员)与导入(按名称+课程+默认签发方匹配更新或新建,全成功 201、部分成功 207、全失败 400);provider-config 与 external-mapping 的创建/停用/删除(需平台管理员);以及 assertions-over-time、course-assertions-over-time、credentials-over-time 分析端点(可传 start_date/end_date,YYYY-MM-DD)。
适用场景与限制:适用于签发、分配、导入或报告数字凭证与证书的场景,按角色过滤可见范围(平台管理员、部门管理员、普通用户各自受限,空集合返回 403)。DELETE、分配、签发、导入导出等破坏性或对外可见操作需先与用户确认。配置项键名保存时转为小写、值原样保留;Accredible 配置必须包含 accredible_api_key。该资料未提供价格、平台支持范围等其它信息。