用途:通过 ibl.ai 的 Data Manager(DM)API,管理组织内按用户的功能配置以及应用与引导状态。适合为用户或组织切换功能标志/取值、查看用户应用、记录引导、授予试用或做平台配置。
必要用法:基础地址为 https://api.iblai.app/dm,所有路径都需带 /dm 前缀。请求头使用 Authorization: Api-Token $IBLAI_API_KEY。组织以 platform_key 作为查询参数或请求体字段传递,不写入路径;用户按 user_id、username、email 的优先级从查询参数(GET)或请求体(POST)解析。尚未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
主要能力:
- 功能配置:GET /api/features/config/ 读取用户的 {功能: 取值} 映射;POST /api/features/config/ 创建或更新,支持两种互斥请求体——批量内联 config 对象,或单一 feature + values(两者都缺返回 400,同时存在以 config 优先)。
- 平台级批量:POST /api/features/bulk-config/ 将某功能的取值应用到该平台所有已有 UserFeatureConfig 记录(不会创建新记录),请求体形式同上但无需用户;该操作会重写平台上每个用户的值,需先与用户确认。
- 应用与引导:GET /api/features/apps/ 列出当前令牌用户可访问的应用,支持分页及 app、platform、has_active_subscription、free_trial_started、free_trial_expired、onboarding_completed、时间等过滤;POST /api/features/apps/update/ 设置某应用的引导完成状态(需已有该应用访问权)。
- 试用:POST /api/features/apps/update-trial-status/ 激活用户对某应用的免费试用,仅支持主/默认平台,且用户需有该平台关联;会消耗用户免费试用,需先确认。
- 平台配置:POST /api/provision/{config_name}/ 运行已存储的 PlatformProvisioningConfig,仅当 ENABLE_PLATFORM_PROVISIONING 开启时注册(否则 404),且为平台管理员权限;请求体作为 request_data 传入服务端片段,结果映射作为响应,需先确认。
限制:已注册路由仅上述六条,其中功能/应用类端点权限为 AllowAny,配置端点继承 DM/平台管理员权限;apps、引导与试用端点针对令牌所属用户,无法指定其他用户;app 可按 url、名称或数字 id 解析。Django 管理命令与配置片段编写界面属服务端,不在本 API 范围内。具体收费与价格暂未提供。