千问办公企业旗舰版开发者文档:创建导航插件包上传会话。
- Scope:
admin.v1.personalization-policy-groups.manage - 接口: POST
/api/openapi/v1/personalization/policy-groups/{group_id}/web-plugin-bundle-upload-sessions
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
请求体:必填;Content-Type:application/json。
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
group_id | path | string | 是 | 目标策略组 ID | - |
Idempotency-Key | header | string | 是 | 同一逻辑操作重试使用同一键 | - |
bundle_type | body | string | 是 | 导航插件包类型 取值:"web" 取值:"web" | - |
size_bytes | body | integer · int64 | 是 | 声明的 ZIP 大小,单位字节 | - |
请求示例
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
201 | 请求成功 | 见本文“响应结果” | 读取响应 |
429 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
503 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
default | 其他认证、授权、版本冲突或校验错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态码及错误码处理 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
max_size_bytes | integer · int64 | 是 | 允许的上传大小上限 | - |
upload_headers | object | 是 | 直传时必须发送的请求头 | - |
upload_id | string | 是 | 在导航节点中引用的上传 ID | - |
upload_method | string | 是 | 直传请求方法 | - |
upload_url | string · uri | 是 | 直传地址 | - |
upload_url_expires_at | string · date-time | 是 | 上传地址到期时间 | - |