Skip to main content

查询资源上传状态

按 uploadId 查询资源上传会话的当前状态和校验结果。

所需权限

所需权限资源Scope资源服务
资源上传查询(读取)resource-uploadsadmin.v1.resource-uploads.readqwenwork-biz-service
GET /api/openapi/v1/resource-uploads/{uploadId}

公共请求头

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

请求参数

名称位置类型必填说明示例
uploadIdpathstring · uuid是上传会话 ID"<uuid>"

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。
curl --request GET \
  --url '<BASE_URL>/api/openapi/v1/resource-uploads/<uploadId>' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取响应结果。
default未单独列出的认证、授权、校验或依赖错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态与 code 处理;写操作重试前核实结果及幂等要求。

响应结果

Content-Type: application/json
名称类型必填说明示例
asset_urlstring否资源文件地址"<string>"
created_atstring · date-time是创建时间"2026-08-27T10:00:00Z"
error_codestring否错误码"<string>"
expected_sha256string否预期文件 SHA-256 摘要"<string>"
expires_atstring · date-time是到期时间"2026-08-27T10:00:00Z"
max_size_bytesinteger · int64否文件大小上限(字节)0
media_typestring否文件媒体类型"<string>"
resource_typestring是资源类型 取值:"connector"、"expert_kit"、"skill""skill"
size_bytesinteger · int64否文件大小(字节)0
statusstring是状态 取值:"created"、"expired"、"failed"、"ready"、"uploaded"、"validating""created"
updated_atstring · date-time是更新时间"2026-08-27T10:00:00Z"
upload_headersobject否上传请求头-
upload_idstring · uuid是上传会话 ID"<uuid>"
upload_kindstring是上传类型 取值:"icon"、"package""package"
upload_methodstring否上传 HTTP 方法"<string>"
upload_urlstring否上传地址"<string>"
upload_url_expires_atstring · date-time否上传地址过期时间"2026-08-27T10:00:00Z"

响应示例

{
  "asset_url": "<string>",
  "created_at": "2026-08-27T10:00:00Z",
  "error_code": "<string>",
  "expected_sha256": "<string>",
  "expires_at": "2026-08-27T10:00:00Z",
  "max_size_bytes": 0,
  "media_type": "<string>",
  "resource_type": "skill",
  "size_bytes": 0,
  "status": "created",
  "updated_at": "2026-08-27T10:00:00Z",
  "upload_headers": {},
  "upload_id": "<uuid>",
  "upload_kind": "package",
  "upload_method": "<string>",
  "upload_url": "<string>",
  "upload_url_expires_at": "2026-08-27T10:00:00Z"
}