用途:以 HTTP 方式(无头)把构建好的 Web 应用部署到 ibl.ai 托管并管理其全生命周期,与逐步操作手册 /iblai-vibe-ops-deploy 对应同一批端点。
主要能力:部署(POST zip 构建包,返回 202 后轮询);读取(列出某属主的项目,或轮询单个项目的构建状态、上线 URL、已绑定域名,失败时返回构建日志末尾);域名(绑定自定义域名、读取所需 DNS 记录、轮询验证、解除绑定);公开启动查询(托管应用启动时调用一次以获知所属组织)。
使用方式:基础地址 dm_url=https://api.iblai.app/dm,除公开启动查询外前缀为 {dm_url}/api/ai-agent/orgs/{org}/users/{username}/providers/vercel/hosting;请求头为 Authorization: Api-Token $IBLAI_API_KEY。{username} 是项目属主。所有端点接受可选 provider 参数,默认且仅接受 vercel。{dm_url}/api/ai-mentor/... 指向同一组视图。部署用 multipart/form-data 且必须含 file(zip,≤50 MB 压缩)与 project;首部署需 subdomain 或已配置的 domain。示例命令:curl -s -X POST "$base/deployment/" -H "Authorization: Api-Token $IBLAI_API_KEY" -F "file=@dist.zip" -F "project=my-app" -F "framework=static"。
权限与限制:所有端点要求调用者为 {org} 的组织管理员、组织级 Platform API Token 或服务账号,普通成员即使被授权也会被拒。RBAC 动词位于 Ibl.Mentor/HostingProjects/。未连接需先运行 /iblai-api-login。存档会同步检查并剥离 .git/、node_modules/、__MACOSX/、.next/ 等;无服务端重试,重试需自行处理;轮询成本非恒定,进行中建议每 2–5 秒一次并在终态停止;url 在 READY 前为 null,重新部署期间也会清空。删除项目或解除域名需先向用户确认。字段与 URL 以实时 OpenAPI schema 为准:https://api.iblai.app/dm/api/docs/schema/。
适用场景:需要脚本化、无人值守地发布和维护 ibl.ai 托管应用,并管理其自定义域名与组织归属。