Skip to main content

创建导航插件包上传会话

千问办公企业旗舰版开发者文档:创建导航插件包上传会话。

  • Scope: admin.v1.personalization-policy-groups.manage
  • 接口: POST/api/openapi/v1/personalization/policy-groups/{group_id}/web-plugin-bundle-upload-sessions
为现有组创建上传会话,使用返回的方法、请求头和 URL 直传 ZIP。将 upload_id 填入同一应用、同一组的导航节点插件配置,再更新该组。会话要求幂等键,上传成功本身不改变策略。导航节点使用 web 类型。

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

请求体:必填;Content-Type:application/json。
名称位置类型必填说明示例
group_idpathstring是目标策略组 ID-
Idempotency-Keyheaderstring是同一逻辑操作重试使用同一键-
bundle_typebodystring是导航插件包类型 取值:"web" 取值:"web"-
size_bytesbodyinteger · int64是声明的 ZIP 大小,单位字节-

请求示例

curl --request POST \
  --url 'https://example.invalid/api/openapi/v1/personalization/policy-groups/11111111-1111-4111-8111-111111111111/web-plugin-bundle-upload-sessions' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Idempotency-Key: sales-policy-01' \
  --header 'Content-Type: application/json' \
  --data '{"bundle_type":"web","size_bytes":1024}'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
201请求成功见本文“响应结果”读取响应
429限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
503限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
default其他认证、授权、版本冲突或校验错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态码及错误码处理

响应结果

Content-Type: application/json
名称类型必填说明示例
max_size_bytesinteger · int64是允许的上传大小上限-
upload_headersobject是直传时必须发送的请求头-
upload_idstring是在导航节点中引用的上传 ID-
upload_methodstring是直传请求方法-
upload_urlstring · uri是直传地址-
upload_url_expires_atstring · date-time是上传地址到期时间-

响应示例

{
  "upload_id": "11111111-1111-4111-8111-111111111111",
  "upload_url": "https://example.invalid/upload",
  "upload_method": "PUT",
  "upload_headers": {
    "Content-Type": "application/zip"
  },
  "upload_url_expires_at": "2026-11-03T08:00:00Z",
  "max_size_bytes": 52428800
}