千问办公企业旗舰版开发者文档:查询连接器列表。
认证方式见APP开发者文档 → 认证接入。
200 返回
服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。
列表只返回当前成员可发现的资源,空列表不代表调用失败。分页参数非法或关键词过长返回 400(
- 模块:技能中心
- 权限:按当前用户的资源范围校验,不要求管理员权限。
- 接口:GET
/api/openapi/app/v1/ai-assets/connectors
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| keyword | query | string | 否 | 名称/描述子串搜索,最多 200 字符;保留市场编排顺序。 |
| page | query | integer | 否 | 页码,默认 1,范围 1–1000000。 |
| page_size | query | integer | 否 | 每页数量,默认 20,范围 1–100。 |
响应
200 返回 application/json,直接返回下述对象。
EnterprisemarketAppAssetListResponse
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| items | array<EnterprisemarketAppAsset> | 是 | 当前页可见资源。 |
| page | CatalogsourcePage | 是 | 分页信息。 |
EnterprisemarketAppAsset
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| auth_type | string | 否 | 连接器认证类型。 |
| auto_provided | boolean / null | 是 | 当前自动下发来源;状态不可用时可为 null,不能解释为手动安装。 |
| capabilities | EnterprisemarketAppAssetCapabilities | 是 | 当前可执行的操作标志。 |
| category | string | 是 | 资源分类。 |
| connection_status | string | 是 | 连接状态:true/false/unknown;unknown 不能解释为已连接。 |
| dependencies | EnterprisemarketAppAssetDependencies | 否 | 专家套件依赖数量,不含受限资源详情。 |
| description | string | 是 | 资源描述。 |
| description_cn | string | 是 | 中文描述。 |
| icon_url | string | 是 | 图标地址。 |
| id | string | 是 | 资源 ID;详情使用此值,不使用 market_item_id。 |
| manual_installed | string | 是 | Web 手动登记:true/false/unknown;不证明文件已经下载。 |
| market_item_id | string | 是 | 市场条目 ID。 |
| name | string | 是 | 资源名称。 |
| name_cn | string | 是 | 中文名称。 |
| origin | string | 是 | 资源来源:org 或 public;沿用列表返回值。 可选值:org, public。 |
| requires_auth | boolean | 否 | 连接器是否要求认证,不代表用户已授权。 |
| preparation | WebassetsPreparation | 否 | 最近一次包准备观察;不是本轮已加载的保证。 |
| state_etag | string | 否 | 当前状态版本,写入时作为 If-Match 原样传入。 |
| resource_type | string | 是 | 可选值:skill, expert_kit, connector。 |
| supported_surfaces | array<string> | 是 | 支持的产品端列表。 |
| surface_code | string | 是 | 固定为 qwenwork_web。 可选值:qwenwork_web。 |
| unavailable_reason | string | 是 | 空字符串表示无阻塞原因;可为 state_unavailable、resource_unavailable、state_recovery_required 或 dependency_feature_pending。具体原因以服务端当前返回为准。 |
| user_enabled | string | 是 | 当前有效开关:true/false/unknown;unknown 不等于关闭。 |
| version | string | 是 | 资源版本。 |
EnterprisemarketAppAssetCapabilities
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| can_authorize | boolean | 是 | 当前是否允许发起连接器授权,由资源类型、权限、配置和授权状态决定。 |
| can_install | boolean | 是 | 当前是否允许添加 Web 手动登记,以服务端能力标志为准。 |
| can_toggle | boolean | 是 | 当前是否允许修改 Web 启停偏好,以服务端能力标志为准。 |
| can_uninstall | boolean | 是 | 当前是否允许移除手动来源;自动管理资源的完整卸载受限。 |
| can_use | boolean | 是 | 当前资格和开关允许使用;不保证资源包已准备或本轮已加载。 |
EnterprisemarketAppAssetDependencies
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command_count | integer | 是 | 命令数量。 |
| connector_count | integer | 是 | 连接器数量。 |
| skill_count | integer | 是 | 技能数量。 |
CatalogsourcePage
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| current_page | integer | 是 | 当前页码。 |
| last_page | integer | 是 | 最后一页页码。 |
| next_page | integer | 是 | 下一页页码。 |
| page_size | integer | 是 | 每页数量。 |
| prev_page | integer | 是 | 上一页页码。 |
| total_size | integer | 是 | 可见资源总数。 |
WebassetsPreparation
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| observed_at | string | 否 | 最近观察时间,RFC 3339;不是实时执行状态。 |
| state | string | 是 | 准备状态:pending、preparing、prepared、failed、stale 或 unknown。 可选值:pending, preparing, prepared, failed, stale, unknown。 |
| version | string | 否 | 观察到的资源包版本。 |
使用说明
服务端确定组织、用户和 Web 策略范围,并检查业务准入、资源有效性、Web 兼容性及 DISCOVER 权限。
列表只返回当前成员可发现的资源,空列表不代表调用失败。分页参数非法或关键词过长返回 400(market_validation_failed)。
技能及基础专家套件可按 capabilities 使用 Web 安装/启停接口;连接器的安装、启停和授权按当前 capabilities 及对应接口处理;授权成功不代表沙箱已可执行。状态不可用时保留目录结果并返回 unknown/state_unavailable,不假定未安装。目录响应不含下载地址、执行配置或凭据。