用途:通过 ibl.ai 的 Data Manager(DM)API 管理按用户的功能配置与应用/引导状态,适用于切换用户或组织的功能开关、查看用户应用、记录引导、授予试用或配置平台。
主要能力:读取用户功能配置(GET /api/features/config/,返回 {feature: values} 映射);写入或更新配置(POST 同路径,支持批量内联 config 对象或单个 feature+values 两种互斥体);跨平台批量覆盖已有配置(POST /api/features/bulk-config/,仅更新不创建);列出当前令牌用户可访问的应用(GET /api/features/apps/,支持分页与多种过滤);设置某应用引导状态(POST /api/features/apps/update/);激活应用免费试用(POST /api/features/apps/update-trial-status/,仅主平台支持);在平台启用时运行平台配置(POST /api/provision/{config_name}/,仅平台管理员)。
使用方式:基础地址为 https://api.iblai.app/dm,所有请求需带 Authorization: Api-Token $IBLAI_API_KEY。组织以 platform_key 作为查询参数或请求体字段传递,用户按 user_id、username、email 优先级解析。未连接时先运行 /iblai-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。示例:curl -X POST "https://api.iblai.app/dm/api/features/config/" -H "Authorization: Api-Token $IBLAI_API_KEY" -H "Content-Type: application/json" -d '{"username":"'"$IBLAI_USERNAME"'","platform_key":"'"$IBLAI_ORG"'","feature":"chat_ui","values":{"enabled":true,"theme":"dark"}}'。
限制:功能配置、批量配置、应用、引导与试用视图权限为 AllowAny,但应用/引导/试用仍读取令牌识别用户,无法指定其他用户;配置写入缺少 config 或 feature+values 返回 400,平台键无法解析或写入失败返回 500;批量配置不创建新记录;试用仅主平台支持且需用户已有平台链接;配置端点受 ENABLE_PLATFORM_PROVISIONING 控制,关闭时返回 404,且仅平台管理员可用。破坏性或对外操作(试用激活、批量覆盖、平台配置)需先与用户确认。管理命令与配置片段编写在服务端,不属于本 REST 接口范围。