千问办公企业旗舰版开发者文档:提交企微连接器配置。
认证方式见APP开发者文档 → 认证接入。
key 仅允许 wecom。请求 JSON:
服务端确定 org/user/qwenwork_web,固定内置身份不可由浏览器伪造。添加、配置、授权和启用检查 connector_publish / DISCOVER、INVOKE 与 connector_use / USE 当前权限。本人可清理已撤权登记,不能操作其他用户。OAuth 登录不授予资源权限。
登记使用 Web 独立状态,source_channel=builtin,不伪造市场条目,不产生市场下载统计。重复添加保留选择;首次添加默认关闭;完整卸载重装默认关闭。卸载撤销当前授权代际,异步清理 Nango;断开同时停用。授权/配置成功仍需启用;can_use 固定 false,沙箱执行另行接入。
200 返回安全连接状态 ConnectionResponse,不含 Bot Secret 或第三方凭据。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。
- 模块:技能中心
- 权限:按当前用户的资源范围校验,不要求管理员权限。
- 接口:POST
/api/openapi/app/v1/ai-assets/builtin-connectors/{key}/configuration
请求
key 仅允许 wecom。请求 JSON:{"bot_id":"your-bot-id","bot_secret":"your-secret"}。bot_id 长度 1–255,bot_secret 长度 1–4096;均必填,拒绝未知字段、重复字段、换行与空值。密钥只写 Nango,不写 SQL 回执或响应。configured 只证明保存,不验证第三方可达性。
| 请求头 | 必填 | 说明 |
|---|---|---|
| If-Match | 是 | 最近读取的 auth_revision,原样携带,不能为星号。 |
| 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 返回安全连接状态 ConnectionResponse,不含 Bot Secret 或第三方凭据。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。
WebassetsConnectionResponse
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| attempt_id | string | 否 | 当前授权尝试 UUID,用于关联本次授权流程。 |
| auth_revision | string | 是 | 授权状态版本;授权写操作按接口要求原样作为 If-Match 传入。 |
| auth_type | string | 否 | 连接器使用的授权方式,按实际响应返回。 |
| can_authorize | boolean | 是 | 当前用户是否可以发起授权。 |
| can_use | boolean | 是 | 当前状态是否允许使用;不能仅凭 connected 判断可执行。 |
| cleanup_pending | boolean | 是 | 是否仍有后台凭据清理待完成。 |
| connected | boolean | 是 | 是否已建立连接/完成必要配置。 |
| connection_id | string | 否 | 授权连接标识,可能省略;不是用户身份。 |
| operation_id | string | 否 | 后台操作标识,用于后续查询操作结果。 |
| operation_pending | boolean | 是 | 是否仍有操作待完成,不能将 true 当作已完成。 |
| operation_status | string | 否 | 查询到的操作状态,按实际响应返回。 |
| state_available | boolean | 是 | 服务端是否能够提供当前授权状态。 |
| state_etag | string | 否 | 安装/启停状态版本;与 auth_revision 不可互换。 |
| unavailable_reason | string | 否 | 当前不可用原因;省略不代表所有执行条件均满足。 |
| user_enabled | boolean | 是 | 用户是否选择启用该连接器;授权成功不自动等于启用。 |
错误
| 状态码 | 说明 |
|---|---|
| 400 | 参数、请求体或幂等键无效。 |
| 401 / 403 | 身份或业务准入失败。 |
| 404 | 内置项不支持 Web、无权限或本人安装不存在。 |
| 409 | 操作冲突、托管项不能卸载或授权未完成。 |
| 412 | 版本过期,重新查询后提交。 |
| 422 | JSON、请求体或查询参数校验失败。 |
| 428 | 缺少 If-Match。 |
| 503 | IAM、数据库或 Nango 不可用;不降级放行。 |