PDF转换任务查询
适用版本>=v7.0.2502b.20250227
接口说明:PDF转换任务查询
请求说明
| 请求地址 | 配置域名+/openapi+/v7/kdocs/pdf/convert/tasks/{task_id}/meta |
|---|---|
| 请求方法 | GET |
| 签名方式 | KSO-1(配置域名+/openapi不参与签名) |
| 权限要求 | 应用文档PDF转换(应用授权) kso.appfile.pdf_cps.readwrite |
请求头(Header)
| Header | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| X-Kso-Date | string | 是 | RFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT |
| X-Kso-Authorization | string | 是 | KSO-1 签名值,详见《签名方法》 |
| Authorization | string | 是 | 授权凭证,格式为:Bearer {access_token} |
路径参数(Path)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务ID |
响应体(Response)
| 名称 | 类型 | 说明 |
|---|---|---|
| data | object | |
| ∟ err_code | integer | pdf转换任务错误码 |
| ∟ err_msg | string | pdf转换任务错误信息 |
| ∟ status | string | pdf转换任务任务状态,success:成功;running:进行中;failed:失败; |
| ∟ file | object | 文件信息 |
| ∟ ∟ created_by | object | 创建者信息 |
| ∟ ∟ ∟ ∟ id | string | 身份ID |
| ∟ ∟ ∟ ∟ type | string | Enum: "user" "sp",身份类型 |
| ∟ ∟ ctime | integer | 创建时间,时间戳,单位为秒 |
| ∟ ∟ drive | object | 驱动盘信息 |
| ∟ ∟ ∟ ∟ allotee_id | string | 盘归属的应用id,长度不超过1024位 |
| ∟ ∟ ∟ ∟ allotee_type | string | 盘归属身份类型,固定为app |
| ∟ ∟ ∟ ∟ company_id | string | 企业id(应用文档:忽略此参数) |
| ∟ ∟ ∟ ∟ created_by | object | 创建者信息 |
| ∟ ∟ ∟ ∟ ∟ ∟ id | string | 身份ID |
| ∟ ∟ ∟ ∟ ∟ ∟ type | string | Enum: "user" "sp",身份类型 |
| ∟ ∟ ∟ ∟ ctime | integer | 创建时间,时间戳,单位为秒 |
| ∟ ∟ ∟ ∟ description | string | 盘描述 |
| ∟ ∟ ∟ ∟ ext_attrs | object[] | 盘扩展属性 |
| ∟ ∟ ∟ ∟ ∟ ∟ name | string | 名称 |
| ∟ ∟ ∟ ∟ ∟ ∟ value | string | 值 |
| ∟ ∟ ∟ ∟ id | string | 驱动盘id |
| ∟ ∟ ∟ ∟ mtime | integer | 修改时间,时间戳,单位为秒 |
| ∟ ∟ ∟ ∟ name | string | 驱动盘名称 |
| ∟ ∟ ∟ ∟ permission_mode | string | Enum: "builtin" "callback",权限校验模式 |
| ∟ ∟ ∟ ∟ quota | object[] | 盘容量(应用文档:返回-1) |
| ∟ ∟ ∟ ∟ ∟ ∟ deleted | integer | 回收站中的文件占用的总空间,以字节为单位。只读。 |
| ∟ ∟ ∟ ∟ ∟ ∟ remaining | integer | 剩余的总空间,以字节为单位。只读。 |
| ∟ ∟ ∟ ∟ ∟ ∟ total | integer | 允许的总存储空间,以字节为单位。只读。 |
| ∟ ∟ ∟ ∟ ∟ ∟ used | integer | 已使用的总空间,以字节为单位。只读。 |
| ∟ ∟ ∟ ∟ source | string | 盘来源,应用文档:appfile |
| ∟ ∟ ∟ ∟ status | string | Enum: "inuse" "deleted",盘状态 |
| ∟ ∟ ∟ ∟ storage_mode | string | Enum: "tree" "kv",驱动盘组织结构 |
| ∟ ∟ drive_id | string | 驱动盘id |
| ∟ ∟ id | string | 文件id |
| ∟ ∟ link_id | string | 链接id(应用文档:忽略此参数) |
| ∟ ∟ link_url | string | 链接url(应用文档:忽略此参数) |
| ∟ ∟ modified_by | object | 修改者信息 |
| ∟ ∟ ∟ ∟ id | string | 身份ID |
| ∟ ∟ ∟ ∟ type | string | Enum: "user" "sp",身份类型 |
| ∟ ∟ mtime | integer | 修改时间,时间戳,单位为秒 |
| ∟ ∟ name | string | 文件名 |
| ∟ ∟ parent_id | string | 父目录id(应用文档:0) |
| ∟ ∟ shared | boolean | 是否开启分享(应用文档:false) |
| ∟ ∟ size | integer | 文件大小 |
| ∟ ∟ type | string | Enum: "folder" "file" "shortcut",文件类型(应用文档:file) |
| ∟ ∟ version | integer | 文件版本号 |
| code | int | 错误码 |
| msg | string | 状态信息 |
| detail | string | 详细信息 |
响应体示例
json
{
"data": {
"err_code": 0,
"err_msg": "string",
"file": {
"created_by": {
"id": "string",
"type": "sp"
},
"ctime": 0,
"drive": {
"allotee_id": "string",
"allotee_type": "app",
"company_id": "string",
"created_by": {
"id": "string",
"type": "sp"
},
"ctime": 0,
"description": "string",
"ext_attrs": [
{
"name": "string",
"value": "string"
}
],
"id": "string",
"mtime": 0,
"name": "string",
"permission_mode": "callback",
"quota": {
"deleted": -1,
"remaining": -1,
"total": -1,
"used": -1
},
"source": "string",
"status": "inuse",
"storage_mode": "kv"
},
"drive_id": "string",
"id": "string",
"link_id": "string",
"link_url": "string",
"modified_by": {
"id": "string",
"type": "sp"
},
"mtime": 0,
"name": "string",
"parent_id": "string",
"shared": false,
"size": 0,
"type": "file",
"version": 0
},
"status": "success"
},
"code": 0,
"detail": "string",
"msg": "string"
}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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62