查询上传状态

查询上传任务状态，获取上传结果。

基本信息

项目	值
方法	GET
路径	{globalDomain}/ous/api/v2/upload/status
认证	ous-token-v2

说明

ousToken 已绑定 taskId，无需额外参数。

Request

无参数，Token 已绑定任务。

Example

curl

curl -X GET '{globalDomain}/ous/api/v2/upload/status' \
  -H 'ous-token-v2: {ousToken}'

Python

import requests

url = f"{globalDomain}/ous/api/v2/upload/status"
headers = {"ous-token-v2": ousToken}

response = requests.get(url, headers=headers)

JavaScript

const response = await fetch(
  `https://${globalDomain}/ous/api/v2/upload/status`,
  {
    headers: { 'ous-token-v2': ousToken }
  }
);

Response

成功响应（status = 5）

{
  "c": "0",
  "d": {
    "status": 5,
    "uploadKey": "path/to/file.jpg",
    "url": "https://cdn.aholo.ai/path/to/file.jpg",
    "md5": "c2ce57814593ae4e9fa8f1f473a3ed47",
    "obsTaskId": "3FO4K029K4A3"
  }
}

进行中响应（status = 4）

{
  "c": "0",
  "d": {
    "status": 4,
    "taskId": "upload_task_id"
  }
}

字段说明

字段	类型	说明
status	int	状态码，见下方状态码表
uploadKey	string	文件存储 Key
url	string	文件访问 URL
md5	string	文件 MD5 值

状态码

Status	含义	终态
0-4	处理中	否
5	上传成功	✅
6	上传失败	✅
8	手动中止	✅

使用 URL

当 status 为 5 时，d.url 可用于后续创建项目的 resources.url 参数。

轮询建议

• 轮询间隔：200ms 以上
• 总时长：超过 5s 无结果可视为失败
• 成功判定：status === 5