查询任务进度
... 2026-2-4 大约 2 分钟
# 查询任务进度
# 接口说明
查询（导入/导出/上传/下载）任务的进度
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/drive/v3/tasks/{taskId} |
| Method | GET |
| Content-Type | application/json; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 路径参数
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| taskId | string | 是 | 上传任务 Id |
# 查询参数
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| type | enum(TaskType) | 是 | 任务类型 |
# 任务类型 TaskType
| 字段 | 描述 |
|---|---|
| IMPORT | 导入任务 |
| EXPORT | 导出任务 |
| UPLOAD | 上传任务 |
| DOWNLOAD | 下载任务 |
| CONVERT_EXPORT_PDF | DOC转PDF任务 |
# 请求示例
curl --location 'https://{domain}/openapi/drive/v3/tasks/1022447688093794304_590dd82e-02b8-ad4a-03c6-29de6eb82f1e?type=IMPORT' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID'
1
2
3
2
3
1
2
3
2
3
# 响应参数
# 响应体
导入/上传任务成功则会返回文件信息(FileInfo)
导出/下载/doc转PDF任务成功则会返回文件下载链接
# 响应示例
导入/上传任务成功则会返回文件信息
{
"meta": {
"id": "DQUpMUmlpQ2ltcGNk",
"parentId": "AKTQTmGvOCyH",
"name": "导入文档样例",
"type": "DOC",
"ext": "tencentsheet",
"status": "NORMAL",
"url": "https://{domain}/doc/DQUpMUmlpQ2ltcGNk",
"icon": "https://{domain}/private_cdn/tim/docs/docs-design-resources/mobile/png@3x/file_sheet_64@3x-28f87b2076.png",
"creator": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"createTime": "1684846762855",
"owner": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"lastModifyingUser": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"modifiedTime": "1684846762855",
"accessTime": "1684846762858",
"isFolder": false,
"isLink": false
},
"entry": {
"sourceParentId": "",
"deleteTime": "0",
"isTop": false,
"topTime": "0",
"isStar": false,
"starTime": "0"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
导出/下载任务成功则会返回文件下载链接
{
"fileUrl": "https://{domain}/docstorage//tencent-docs-1251316161/4652bcab5b3d42028f90677f11bd05df?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minioadmin%2F20230523%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230523T115507Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D2408776.2408794.pdf%3Bfilename%2A%3Dutf-8%27%272408776.2408794.pdf&X-Amz-Signature=ce352e61e313cab5bd656603fe56c2a431f8121adb3ac1080cb657757b9904c2"
}
1
2
3
2
3
1
2
3
2
3
# 错误码
# 业务错误码
业务错误码 对应 Error对象中的 internalCode
| 业务错误码 | 描述 |
|---|---|
| 402601 | 导入、上传任务进行中 |
| 402602 | 导入、上传任务已取消 |
{
"code": 400010,
"message": "Task canceled",
"internalCode": 402602
}
1
2
3
4
5
2
3
4
5
1
2
3
4
5
2
3
4
5