用途:通过 ibl.ai 平台 API 管理组织的数字凭证与证书,覆盖凭证创建与编辑、分配给用户或群组、读取已签发凭证(断言)、课程级凭证导入导出、配置外部签发方(如 Accredible)及查看签发趋势分析。
认证与约定:基础地址为 https://api.iblai.app/dm,路径需带 /dm 前缀;每个请求携带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径中 {org} 对应 $IBLAI_ORG(即 platform_key,回退 Platform.org),用户段可用数字 user_id 或 $IBLAI_USERNAME,{course_id} 为 Open edX 课程 id(如 course-v1:org+course+run)。详情类接口仅接受 entity_id(UUID),不接受数字数据库 id。响应统一包裹为 status 与 result;列表分页含 count、next、previous 及 results 或 data。删除、签发、分配、导入导出等破坏性或对外操作需先与用户确认。未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
主要能力:凭证的列表、读取、创建、更新、删除与图片上传;签发方与签署人管理;用户与群组分配(群组分配异步处理);断言的列表、读取、撤销、单个与批量签发,以及公开断言查询;课程凭证导入导出(exim,仅 DM 管理员);外部签发方配置与凭证映射;签发量、课程签发量、凭证创建量随时间变化的分析(部分仅平台管理员)。
使用方式:列表接口支持 page、page_size(默认 10,最大 100;provider/mapping 默认 50,最大 1000)、search 等参数,结果按创建或分配时间倒序。创建凭证需 name 与 issuer(签发方 entity_id),其余字段可选,signal 默认 COURSE_PASSED。分配用户使用 credential_id 与数字 user_ids;分配群组使用 credential_id 与字符串 group_ids。签发断言需 recipient 及 course、catalog_item、program 或 pathway 之一。
适用场景:需要批量签发课程证书、按群组分配凭证、跨平台迁移课程凭证或对接 Accredible 等外部签发平台并统计签发情况时使用。
限制:部分接口仅平台管理员或 DM 管理员可用;部门管理员仅能看到本部门范围数据,无权限时返回 403;删除仍有有效断言的凭证返回 409;公开断言查询无需认证,未找到或已撤销返回 404。具体收费、价格与平台支持范围资料未提供。