千问办公企业旗舰版开发者文档:卸载内置连接器。
认证方式见APP开发者文档 → 认证接入。
key 仅允许 dws、lark、wecom。请求体为空,不接受市场条目 ID、组织、用户或适配端参数。
服务端确定 org/user/qwenwork_web,固定内置身份不可由浏览器伪造。添加、配置、授权和启用检查 connector_publish / DISCOVER、INVOKE 与 connector_use / USE 当前权限。本人可清理已撤权登记,不能操作其他用户。OAuth 登录不授予资源权限。
登记使用 Web 独立状态,source_channel=builtin,不伪造市场条目,不产生市场下载统计。重复添加保留选择;首次添加默认关闭;完整卸载重装默认关闭。卸载撤销当前授权代际,异步清理 Nango;断开同时停用。授权/配置成功仍需启用;can_use 固定 false,沙箱执行另行接入。
200 返回MutationResult,含 state_etag、resource。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。
- 模块:技能中心
- 权限:按当前用户的资源范围校验,不要求管理员权限。
- 接口:DELETE
/api/openapi/app/v1/ai-assets/builtin-connectors/{key}/installations
请求
key 仅允许 dws、lark、wecom。请求体为空,不接受市场条目 ID、组织、用户或适配端参数。
| 请求头 | 必填 | 说明 |
|---|---|---|
| If-Match | 是 | 最近读取的 state_etag,原样携带,不能为星号。 |
| Idempotency-Key | 是 | 8–128 字符稳定键;响应丢失时保持键与原请求重试。 |
行为与权限
服务端确定 org/user/qwenwork_web,固定内置身份不可由浏览器伪造。添加、配置、授权和启用检查 connector_publish / DISCOVER、INVOKE 与 connector_use / USE 当前权限。本人可清理已撤权登记,不能操作其他用户。OAuth 登录不授予资源权限。
登记使用 Web 独立状态,source_channel=builtin,不伪造市场条目,不产生市场下载统计。重复添加保留选择;首次添加默认关闭;完整卸载重装默认关闭。卸载撤销当前授权代际,异步清理 Nango;断开同时停用。授权/配置成功仍需启用;can_use 固定 false,沙箱执行另行接入。
响应
200 返回MutationResult,含 state_etag、resource。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。
WebassetsMutationResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| resource | WebassetsResource | 是 | 本人资源身份、安装登记及偏好;不包含资源包或凭据。 |
| state_etag | string | 是 | 当前组织/用户/Web 状态版本;写入时作为 If-Match 原样传入。 |
WebassetsResource
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| confirmed_generation | string | 否 | 恢复后该资源的已确认代际;客户端不得自行设置。 |
| enabled | boolean | 否 | 用户启停选择;false 同样覆盖自动下发资源,不能为 null。 |
| id | string | 是 | 资源 UUID,不是市场条目 ID。 |
| lifecycle_epoch | integer | 是 | 服务端资源生命周期代际,仅用于控制一致性。 |
| manual_install | WebassetsInstallation | 否 | 手动登记实例;自动资源不因下发而创建该字段。 |
| origin | string | 是 | org 或 public,沿用目录返回的来源。 可选值:org, public。 |
| resource_type | string | 是 | 支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。 |
WebassetsInstallation
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| installation_id | string | 是 | 服务端生成的手动安装实例 UUID;完整卸载后重装生成新实例。 |
| registered_at | string | 是 | 手动登记时间,RFC 3339。 |
| source_channel | string | 是 | 登记来源渠道;内置连接器为 builtin。 |
| source_market_item_id | string | 是 | 来源市场条目标识;内置连接器不对应市场条目,不据此发起市场查询。 |
错误
| 状态码 | 说明 |
|---|---|
| 400 | 参数、请求体或幂等键无效。 |
| 401 / 403 | 身份或业务准入失败。 |
| 404 | 内置项不支持 Web、无权限或本人安装不存在。 |
| 409 | 操作冲突、托管项不能卸载或授权未完成。 |
| 412 | 版本过期,重新查询后提交。 |
| 422 | JSON、请求体或查询参数校验失败。 |
| 428 | 缺少 If-Match。 |
| 503 | IAM、数据库或 Nango 不可用;不降级放行。 |