SuperAPI AI 工具集

iblai-credentials

编程与开发

查看项目

更新于 10-16 05:55

技能介绍

用途:通过 ibl.ai 平台 API 管理组织的数字凭证与证书,包括签发、分配、导入和报表。

主要能力:凭证 CRUD;签发方与签署人管理;向用户或群组分配凭证;读取断言(已签发凭证);课程范围凭证的导入导出;配置外部签发方(如 Accredible)及凭证到外部模板的映射;按时间拉取签发分析。

使用方式:基础地址为 https://api.iblai.app/dm,所有请求需带 Authorization: Api-Token $IBLAI_API_KEY。路径中 {org} 为平台 key,{user} 可为数字 id 或用户名,{course_id} 为 Open edX 课程 id(如 course-v1:org+course+run)。多数路径位于 /api/credentials/orgs/{org}/users/{user}/… 之下;课程导入导出、公开断言查询和公开提供方列表无 org/user 段。详情端点仅接受 entity_id(UUID),不接受数字数据库 id。响应统一包裹为 status 与 result,分页结果含 count、next、previous 及 results 或 data。列表支持 page、page_size(默认 10,最大 100;提供方/映射列表默认 50,最大 1000)与 search。

限制与注意:DELETE、破坏性及对外操作(分配、签发、导入导出)需先与用户确认。删除凭证若仍有有效断言会返回 409。群组分配异步处理。部门管理员仅见本部门范围。未连接时先运行 /iblai-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。公开断言查询无需认证,未找到或已撤销返回 404。提供方配置与外部映射需平台管理员权限。