Skip to content

批量获取文件信息

适用版本>=v7.0.2312b.20231221

接口说明:批量获取文件信息

请求说明

请求地址配置域名+/graph+/v7/files/batch_get_meta
请求方法POST
签名方式WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名)
权限要求更新文件(用户授权) kso.file.write 查询文件(用户授权) kso.file.read 应用查询文件(应用授权) kso.appdrive.file.read

请求头(Header)

名称是否必填说明
Content-Type固定为: application/json
Wps-Docs-Date取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization计算方法参考签名说明
Authorization授权凭证,格式为: Bearer {access_token}

请求体(Body)

名称类型是否必填说明
file_idsstring[]文件ids,<= 1024 items [ items <= 1024 characters ]

请求体示例

{
  "file_ids": [
    "string"
  ]
}

响应体(Response)

名称类型说明
codeinteger错误码
detailstring详细信息
msgstring状态信息
dataobject
itemsobject[]数据集合,<= 1024 items
idstring文件id
drive_idstring驱动盘id
parent_idstring父文件id
created_byobject创建者信息
avatarstring创建者头像,<= 1024 characters
company_idstring创建者企业id,<= 1024 characters
idstring创建者id,<= 1024 characters
namestring创建者名称,<= 1024 characters
typestring创建者身份类型,user:用户
modified_byobject修改者信息
avatarstring修改者头像,<= 1024 characters
company_idstring修改者企业id,<= 1024 characters
idstring修改者id,<= 1024 characters
namestring修改者名称,<= 1024 characters
typestring修改者身份类型,user:用户
sizeint64文件大小
versionint文件版本
typestring文件类型,folder:文件夹;file:文件
namestring文件名称
ctimeint64文件创建时间,时间戳,单位为秒
mtimeint64文件修改时间,时间戳,单位为秒
hashobject文件哈希信息
sumstring哈希结果
typestring哈希类型,固定为s2s
ext_attrsobject[]文件扩展属性
namestring属性名
valuestring属性值
permissionobject文件权限
link_urlstring分享链接
link_idstring分享链接id

响应体示例

{
  "data": {
    "items": [
      {
        "created_by": {
          "avatar": "string",
          "company_id": "string",
          "id": "string",
          "name": "string",
          "type": "user"
        },
        "ctime": 0,
        "drive_id": "string",
        "ext_attrs": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "hash": {
          "sum": "string",
          "type": "s2s"
        },
        "id": "string",
        "link_id": "string",
        "link_url": "string",
        "modified_by": {
          "avatar": "string",
          "company_id": "string",
          "id": "string",
          "name": "string",
          "type": "user"
        },
        "mtime": 0,
        "name": "string",
        "parent_id": "string",
        "permission": {
          "comment": true,
          "copy": true,
          "copy_content": true,
          "delete": true,
          "download": true,
          "list": true,
          "move": true,
          "new_empty": true,
          "perm_ctl": true,
          "preview": true,
          "print": true,
          "rename": true,
          "share": true,
          "update": true,
          "upload": true
        },
        "size": 0,
        "type": "folder",
        "version": 0
      }
    ]
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}