**版本：202601**

# 查询文件上传任务详情

**GET** `/openapi/2026-01/file/task/:task_id`

获取已创建的文件上传任务的状态和详情。

## 请求

**Path参数**

- `task_id` string (required)

  任务 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `task_id` string

    任务 ID
  - `total` int32

    总计
  - `finished` int32

    是否已完成
  - `status` int32

    状态
  - `success_list` object[]

    成功列表

    *   Array \[

    - `file_uri` string

      文件 URL
    - `origin_link` string

      文件的原始链接
    - `upload_link` string

      上传文件链接
    *   \]
  - `failure_list` string[]

    失败列表
  - `origin_list` string[]

    来源列表

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "task_id": "string",
    "total": 0,
    "finished": 0,
    "status": 0,
    "success_list": [
      {
        "file_uri": "string",
        "origin_link": "string",
        "upload_link": "string"
      }
    ],
    "failure_list": [
      "string"
    ],
    "origin_list": [
      "string"
    ]
  }
}
```