查询文件信息

... 2026-2-4 大约 1 分钟

# 查询文件信息

# 接口说明

根据文件Id进行查询,返回文件信息。

# 请求格式

描述 定义
Path /openapi/drive/v3/files/{fileId}
Method GET
Content-Type application/json; charset=utf-8

# 请求头部

详见Headers

# 请求参数

# 查询参数

参数名 类型 必选 描述
fileId string 文件 Id,文件的唯一标识。

# 请求示例

curl --location 'https://{domain}/openapi/drive/v3/files/DQVRkTllNZ1pyeHhY' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' 
1
2
3
1
2
3

# 响应参数

# 响应体

接口请求成功则会返回文件信息(FileInfo)。

# 响应示例

{
    "meta": {
        "id": "DQVRkTllNZ1pyeHhY",
        "parentId": "AKTQTmGvOCyH",
        "name": "V3测试不聪明表",
        "type": "SHEET",
        "ext": "tencentsheet",
        "status": "NORMAL",
        "url": "https://{domain}/sheet/DQVRkTllNZ1pyeHhY",
        "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": "1684911713923",
        "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": "1684911713923",
        "accessTime": "1684911713925",
        "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
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

# 错误码

查询通用错误码

上次编辑于: 2026年2月4日 15:01
贡献者: daleshen