使用 Authorization: Bearer <API_KEY>。应用必须配置全部用户范围 subject_scope={"mode":"all"},受限范围返回 403。
使用
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
无响应体。HTTP 状态码:204.
HTTP 422 / environment_package_invalid 的错误根含 field、reason(string,均必填),用于定位非法输入。它们是该业务分支的顶层字段,不是所有错误共有的 details 子字段。
保留现有 UI 服务的错误码与校验。401/403 表示认证或授权失败;409 表示冲突,应重新读取后重试;413 表示请求过大;400/422 表示参数校验失败;503 表示依赖不可用。
以实际响应及机器契约为准。创建类幂等操作重试应使用相同 Idempotency-Key 与相同请求。
Authorization: Bearer <API_KEY>。应用必须配置全部用户范围 subject_scope={"mode":"all"},受限范围返回 403。各 Scope 独立授权。响应不应缓存。复用 UI 环境依赖包服务。先向 uploads 以 multipart/form-data 上传单个 file,再用 JSON 元数据及 upload_id 创建或替换。文件非空且不超过 1 GiB;回执绑定组织和上传者,一小时有效、只能消费一次。替换必须提交 expected_revision,保留原 dependency/platform/arch 和 enabled。服务计算大小与 SHA-256;不检测可执行文件兼容性。列表保留 UI 的筛选与分页,不聚合全部页。写入及长上传会重新校验应用当前授权。
所需权限
| 所需权限 | 资源 | Scope | 资源服务 |
|---|---|---|---|
| 环境依赖包管理(manage) | environment-packages | admin.v1.environment-packages.manage | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。
Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| id | path | string | 是 | 记录 ID | - |
| expected_revision | query | integer · int64 | 是 | 最近一次读取的版本号; format="int64", minimum=1 | - |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 204 | 请求成功 | 无响应体 | 确认 HTTP 状态码,不解析正文。 |
| default | 未单独列出的认证、授权、校验或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态与 code 处理;写操作重试前核实结果及幂等要求。 |