用途:通过 ibl.ai 数据管理器(DM)API 管理组织目录中的媒体资源,包括视频、图片、文档、音频、其他类型文件及外部链接,可关联到课程、单元、具体资源项或三者组合。适用于为目录内容附加媒体、浏览或搜索组织媒体、上传媒体文件。
主要能力:媒体资源支持列表与筛选、按数字 id 获取单条、搜索动作、按目录项查询,以及创建、全量更新、部分更新和删除。item_type 由服务端根据传入的 course_id / unit_id / item_id 自动推导,客户端不可发送,响应中只读。
使用方式:基础地址为 https://api.iblai.app/dm,所有路由位于 /api/media/orgs/{org}/users/{user_id}/media/media-resources/ 下。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。{org} 对应 $IBLAI_ORG,{user_id} 为数字用户 id(非用户名)。未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。列表筛选参数优先级互斥:search,否则 course_id + unit_id,否则 course_id,否则 unit_id,否则 item_id。搜索接口 q 必填。按项接口 item_type 与 item_id 均必填,缺失返回 400。创建与更新接受 JSON 或 multipart/form-data,至少需提供 course_id / unit_id / item_id 之一,且需提供 file 上传或 file_url 外部链接之一。
限制:创建、更新、删除仅限管理员;路径中的 user_id 需对 {org} 平台有活跃 UserPlatformLink,读操作仅需该链接,写操作还需 is_admin。同一 item_type + item_id 下重复的 file/file_url 会被拒绝为 400。删除、上传等破坏性或对外调用需先与用户确认。分页使用 page_size(默认 10,最大 100)与 page,返回自定义信封结构。未知组织返回空结果或写操作权限失败。