Skip to main content

查询当前客户端下载目录

使用具有下列 Scope 的 API Key,应用用户范围必须为 subject_scope={"mode":"all"}。

使用具有下列 Scope 的 API Key,应用用户范围必须为 subject_scope={"mode":"all"}。企业由鉴权后的 API Key 决定,不接受调用方指定企业。响应 Cache-Control: no-store;拒绝未知、重复和空查询参数。两个查询接口共用一个安装包读取 Scope。查询不改变下载配置或升级任务。返回已配置下载版本,按操作系统和架构分组,仅包含已启用的完整安装包。未设置下载版本或无专属打包权益时返回 {"items":[]},不回退到最新版本。迁移遗留设置保留既有截止时间前按平台选版本的规则。托管下载链接有效期 30 分钟;外部链接保持原有效期。

所需权限

所需权限资源Scope资源服务
客户端安装包(读取)client-downloadsadmin.v1.client-downloads.readqwenwork-biz-service
GET /api/openapi/v1/client-downloads

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;本查询无需 Idempotency-Key。

请求参数

无请求参数。

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl --request GET \
  --url '<BASE_URL>/api/openapi/v1/client-downloads' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取结果。
default认证、授权、参数校验或依赖错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按 HTTP 状态和 code 处理。

响应结果

Content-Type: application/json
名称类型必填说明示例
itemsarray<object> | null是结果列表-

items[]

字段类型必填说明
packagesarray<object> | null是已启用的完整安装包
platformstring是操作系统; enum=["windows", "macos", "linux", "harmony"] 取值:"harmony"、"linux"、"macos"、"windows"
release_notestring是版本更新说明
titlestring是版本标题
updated_atstring · date-time是更新时间; format="date-time"
versionstring是版本号

items[].packages[]

字段类型必填说明
archstring是CPU 架构; enum=["x64", "arm64", "universal64"] 取值:"arm64"、"universal64"、"x64"
checksum_md5string是MD5 校验值;空值表示未提供
download_urlstring是可直接下载的地址;托管文件签名有效期为 30 分钟,外部链接保持原值
size_bytesinteger · int64是文件大小(字节);0 表示未提供; format="int64"
versionstring是版本号

响应示例

{
  "items": [
    {
      "platform": "macos",
      "version": "1.2.3",
      "title": "Desktop 1.2.3",
      "release_note": "Bug fixes",
      "updated_at": "2026-10-26T10:00:00Z",
      "packages": [
        {
          "arch": "arm64",
          "version": "1.2.3",
          "download_url": "https://downloads.example.com/client-1.2.3-arm64.dmg",
          "checksum_md5": "0123456789abcdef0123456789abcdef",
          "size_bytes": 331070458
        }
      ]
    }
  ]
}

错误处理

401:API Key 无效;403:Scope、企业身份或用户范围不满足;400/422:查询参数不合法;503:依赖不可用。临时故障采用退避重试。 网关可能在请求到达业务服务前以 HTML 返回 401/403;客户端应先检查 HTTP 状态及 Content-Type,再解析 JSON。业务服务错误使用上述公共错误结构。