使用具有下列 Scope 的 API Key,应用用户范围必须为 subject_scope={"mode":"all"}。
使用具有下列 Scope 的 API Key,应用用户范围必须为 subject_scope={"mode":"all"}。企业由鉴权后的 API Key 决定,不接受调用方指定企业。响应 Cache-Control: no-store;拒绝未知、重复和空查询参数。两个查询接口共用一个安装包读取 Scope。查询不改变下载配置或升级任务。返回已配置下载版本,按操作系统和架构分组,仅包含已启用的完整安装包。未设置下载版本或无专属打包权益时返回 {"items":[]},不回退到最新版本。迁移遗留设置保留既有截止时间前按平台选版本的规则。托管下载链接有效期 30 分钟;外部链接保持原有效期。
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:
无请求参数。
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
Content-Type: application/json
401:API Key 无效;403:Scope、企业身份或用户范围不满足;400/422:查询参数不合法;503:依赖不可用。临时故障采用退避重试。
网关可能在请求到达业务服务前以 HTML 返回 401/403;客户端应先检查 HTTP 状态及 Content-Type,再解析 JSON。业务服务错误使用上述公共错误结构。
所需权限
| 所需权限 | 资源 | Scope | 资源服务 |
|---|---|---|---|
| 客户端安装包(读取) | client-downloads | admin.v1.client-downloads.read | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;本查询无需 Idempotency-Key。
请求参数
无请求参数。
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 200 | 请求成功 | 见本文“响应结果” | 读取结果。 |
| default | 认证、授权、参数校验或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按 HTTP 状态和 code 处理。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| items | array<object> | null | 是 | 结果列表 | - |
items[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| packages | array<object> | null | 是 | 已启用的完整安装包 |
| platform | string | 是 | 操作系统; enum=["windows", "macos", "linux", "harmony"] 取值:"harmony"、"linux"、"macos"、"windows" |
| release_note | string | 是 | 版本更新说明 |
| title | string | 是 | 版本标题 |
| updated_at | string · date-time | 是 | 更新时间; format="date-time" |
| version | string | 是 | 版本号 |
items[].packages[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| arch | string | 是 | CPU 架构; enum=["x64", "arm64", "universal64"] 取值:"arm64"、"universal64"、"x64" |
| checksum_md5 | string | 是 | MD5 校验值;空值表示未提供 |
| download_url | string | 是 | 可直接下载的地址;托管文件签名有效期为 30 分钟,外部链接保持原值 |
| size_bytes | integer · int64 | 是 | 文件大小(字节);0 表示未提供; format="int64" |
| version | string | 是 | 版本号 |