获取元数据

该接口用于根据 token 获取各类文件的元数据。

Note 请求用户需要拥有该文件的访问（读）权限

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/suite/docs-api/meta
HTTP Method	POST
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	drive:drive 查看、评论、编辑和管理云空间中所有文件 drive:drive.metadata:readonly 查看云空间中文件元数据

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

参数	类型	必须	说明
request_docs		是	请求文档，一次不超过200个
∟docs_token	string	是	文件的 token，获取方式见概述
∟docs_type	string	是	文件类型 1) "doc": 飞书文档 2) "sheet": 飞书电子表格 3) "bitable": 飞书多维表格 4) "mindnote": 飞书思维笔记 5) "file": 飞书文件 6) "docx": 飞书新版文档

请求体示例

{
    "request_docs": [
        {
            "docs_token": "12345",
            "docs_type": "doc"
        },  
        {
            "docs_token": "12345",
            "docs_type": "sheet"
        }
    ]
}

响应

响应体

参数	说明
docs_metas	文件元数据
∟docs_token	文件token
∟docs_type	文件类型
∟title	标题
∟owner_id	文件拥有者
∟create_time	创建时间（Unix时间戳）
∟latest_modify_user	最后编辑者
∟latest_modify_time	最后编辑时间（Unix时间戳）

响应体示例

{
    "code": 0, 
    "msg": "Success",
    "data": { 
        "docs_metas": [ { 
                "docs_token": "doc22222",
                "docs_type": "doc",
                "title": "abc", 
                "owner_id": "12345", 
                "create_time": 123456, 
                "latest_modify_user": "12345", 
                "latest_modify_time": 123456
            }
        ]
    }
}

错误码

具体可参考：服务端错误码说明