按 uploadId 查询资源上传会话的当前状态和校验结果。
所需权限
| 所需权限 | 资源 | Scope | 资源服务 |
|---|---|---|---|
| 资源上传查询(读取) | resource-uploads | admin.v1.resource-uploads.read | qwenwork-biz-service |
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。
Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| uploadId | path | string · uuid | 是 | 上传会话 ID | "<uuid>" |
请求示例
将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
| 200 | 请求成功 | 见本文“响应结果” | 读取响应结果。 |
| default | 未单独列出的认证、授权、校验或依赖错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态与 code 处理;写操作重试前核实结果及幂等要求。 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| asset_url | string | 否 | 资源文件地址 | "<string>" |
| created_at | string · date-time | 是 | 创建时间 | "2026-08-27T10:00:00Z" |
| error_code | string | 否 | 错误码 | "<string>" |
| expected_sha256 | string | 否 | 预期文件 SHA-256 摘要 | "<string>" |
| expires_at | string · date-time | 是 | 到期时间 | "2026-08-27T10:00:00Z" |
| max_size_bytes | integer · int64 | 否 | 文件大小上限(字节) | 0 |
| media_type | string | 否 | 文件媒体类型 | "<string>" |
| resource_type | string | 是 | 资源类型 取值:"connector"、"expert_kit"、"skill" | "skill" |
| size_bytes | integer · int64 | 否 | 文件大小(字节) | 0 |
| status | string | 是 | 状态 取值:"created"、"expired"、"failed"、"ready"、"uploaded"、"validating" | "created" |
| updated_at | string · date-time | 是 | 更新时间 | "2026-08-27T10:00:00Z" |
| upload_headers | object | 否 | 上传请求头 | - |
| upload_id | string · uuid | 是 | 上传会话 ID | "<uuid>" |
| upload_kind | string | 是 | 上传类型 取值:"icon"、"package" | "package" |
| upload_method | string | 否 | 上传 HTTP 方法 | "<string>" |
| upload_url | string | 否 | 上传地址 | "<string>" |
| upload_url_expires_at | string · date-time | 否 | 上传地址过期时间 | "2026-08-27T10:00:00Z" |