千问办公企业旗舰版开发者文档:创建登录背景上传会话。
- Scope:
admin.v1.personalization.manage - 权限项: 个性化配置管理
- 权限类型: manage
- 接口: POST
/api/openapi/v1/personalization/login-background-upload-sessions
Authorization: Bearer <API_KEY>。应用必须配置全部用户范围 subject_scope={"mode":"all"},受限范围返回 403。各 Scope 独立授权。响应不应缓存。
此上传会话用于更换组织登录页的背景图片。创建会话时提供 Idempotency-Key、media_type 和 size_bytes,按返回的 URL、方法及请求头直传文件。图片须为 PNG 或 JPEG,最大 5 MiB,尺寸至少 720×720。会话绑定组织与上传者。上传完成后,通过「发布登录页配置」接口提交 config.backgroundUploadId,背景才会生效。
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
请求体:必填;Content-Type:application/json。
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Idempotency-Key | header | string | 是 | 幂等键; maxLength=255 | - |
media_type | body | string | 是 | media type; enum=["image/png", "image/jpeg"] 取值:"image/jpeg"、"image/png" | - |
size_bytes | body | integer · int64 | 是 | 文件大小,单位为字节; format="int64", minimum=1, maximum=5242880 | - |
请求示例
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
201 | 请求成功 | 见本文“响应结果” | 读取响应结果。 |
default | 未单独列出的认证、授权、校验或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态与 code 处理;写操作重试前核实结果及幂等要求。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
max_size_bytes | integer · int64 | 是 | 允许的最大文件大小,单位为字节; format="int64" | - |
upload_headers | object | 是 | 上传时需要携带的请求头 | - |
upload_id | string | 是 | 上传会话 ID | - |
upload_method | string | 是 | 上传使用的 HTTP 方法 | - |
upload_url | string · uri | 是 | 文件上传地址; format="uri" | - |
upload_url_expires_at | string · date-time | 是 | 上传地址的过期时间; format="date-time" | - |