文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件管理/ 使用搜索引擎能力检索文件
更新时间:2024-07-30 GMT+08:00

使用搜索引擎能力检索文件

功能介绍

根据搜索范围、父目录、文件名、文件大小区间、更新时间段、所有者等条件搜索空间的文件,普通用户和部门管理员用户可以搜索个人和所在团队的空间,租户管理员可以查询租户下的所有团队空间。

URI

POST /koodrive/ose/v1/files/search

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

String

消息日志跟踪标识(必须58位)

Authorization

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

language

String

国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语

表2 请求Body参数

参数

是否必选

参数类型

描述

searchType

String

查询类型:个人空间、团队空间

pageInfo

pageInfo object

分页信息

filter

filter object

过滤器

sortInfo

sortInfo object

排序信息

recycled

Boolean

是否查询回收站,枚举值:

  • true:查回收站文件

  • false:查对应空间非回收站

缺省值:false

recursived

Boolean

是否递归查询子目录文件,默认false

表3 pageInfo

参数

是否必选

参数类型

描述

pageSize

Integer

每页大小

最小值:1

最大值:100

pageCursor

String

起始游标,为空时从第一页开始查询

表4 filter

参数

是否必选

参数类型

描述

keyWord

String

文件名称,模糊匹配

最小长度:1

最大长度:255

containerId

String

空间id,指定父目录时必传

parentFolder

String

父目录

fileType

String

文件类型,枚举值 /** * 文件夹 / FOLDER("10"), /* * 图片 / PICTURE("15"), /* * 视频 / VIDEO("20"), /* * word / WORD("26"), /* * excel / EXCEL("27"), /* * ppt / PPT("28"), /* * 音频 / AUDIO("30"), /* * 压缩文件 / ARCHIVE("35"), /* * 应用 / APPLICATION("40"), /* * 其他 */ OTHER("45");

updateTimeRange

String

最后更新时间区间

ownerId

String

文件所有者

表5 sortInfo

参数

是否必选

参数类型

描述

sortType

String

枚举类型:

  • fileName:文件名

  • size:文件大小

  • type:文件格式

  • updateTime:最后更新时间

  • createTime:创建时间

  • recycledTime:删除时间

  • fileSuffix:文件格式小类

sortDirection

String

枚举类型:

  • desc:降序

  • asc:升序列

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

code

Integer

响应码,成功返回0,失败返回错误码

msg

String

成功、错误信息

files

Array of files objects

搜索结果

total

Integer

总数

nextPageCursor

String

下一页起始游标,最后一页值为空

表7 files

参数

参数类型

描述

id

String

文件id

fileSuffix

String

文件后缀

fileName

String

文件名

fileType

String

文件类型

size

String

文件大小

updateTime

String

最后更新时间

namePath

String

名称全路径

idPath

String

id全路径

downloadLinks

Array of DownLoadLink objects

图片类型返回,缩略图地址

teamName

String

团队空间返回,部门名称或者群组空间名称

teamId

String

群组id,即部门的id或者群组的id

containerId

String

空间id

containerType

String

0:部门空间,1:个人空间,2:群组空间

favorite

Boolean

个人空间、团队空间返回文件是否被当前用户收藏

owner

String

团队空间返回owner名称

metadataAuditInfo

FileAuditInfo object

文件审核信息

contentAuditInfo

FileAuditInfo object

文件审核信息

表9 FileAuditInfo

参数

参数类型

描述

auditStatus

Integer

审核状态

  • 0:未审核

  • 1:已审核

枚举值:

  • 0

  • 1

auditLevel

Integer

审核级别

  • 10:机审

  • 20:人审

  • 30:机审+人审

  • 99:申诉复审

枚举值:

  • 10

  • 20

  • 30

  • 99

auditResult

Integer

审核结果

  • 1:正常文件

  • 2:内容低敏文件

  • 3:内容高敏文件

  • 4:元信息敏感文件

枚举值:

  • 1

  • 2

  • 3

  • 4

auditDetail

String

审核详情

请求示例

搜索文件请求示例。

POST /koodrive/ose/v1/files/search

Authorization:Bearer+10f88*********4791e9ff
{
  "searchType" : " personal/team",
  "pageInfo" : {
    "pageSize" : 100,
    "pageCursor" : 1
  },
  "filter" : {
    "keyWord" : "材料",
    "containerId" : "123456",
    "parentFolder" : "1",
    "fileType" : "1",
    "sizeRang" : "1024,2048",
    "updateTimeRange" : "2023-11-02,2023-11-21",
    "ownerId" : "归属用户id"
  }
}

响应示例

状态码: 200

搜索结果

{
  "code" : 0,
  "msg" : "success",
  "files" : [ {
    "id" : "Abc",
    "fileName" : "Abc",
    "fileType" : "1",
    "size" : "1024",
    "updateTime" : "2023-05-26T02:08:53.683Z",
    "namePath" : "",
    "downloadLinks" : "",
    "deptName" : ""
  } ],
  "total" : 1000
}

状态码

状态码

描述

200

搜索结果