Get upload file task

GET 
/openapi/2025-06/file/task/:task_id

The Get Upload File Task API retrieves the status and details of an upload task that was previously created using the task_id. It provides information about the task's progress, the number of files processed, and the results (success and failure lists)

Request

Path Parameters

task_id stringrequired

The unique identifier of the upload task

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

task_idstring

The task ID of the upload task

totalint32

The number of files that have been successfully uploaded

finishedint32

If the upload task is finished

statusint32

The status of the upload task

success_list object[]

Success List of the uploaded files

Array [

file_uristring

File URL

origin_linkstring

The origin link of the file

upload_linkstring

The upload file link

]

failure_liststring[]

Failed List of the uploaded files

origin_liststring[]

The original source list of the upload task

Example

{
  "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"
    ]
  }
}