Kingsoft OfficeWPS 365 企业协作开放 API
GET/v7/files/search
搜索文件
按类型、关键字等条件搜索文件。
通过 WPS 365 官方 OpenAPI(v7)管理通讯录与组织、云文档、多维表/智能表格、消息、会议、日历、邮件、待办、审批与事件订阅;官方机器契约为 open.wps.cn 发布的 OpenAPI 3.0.0(827 个 Endpoint / 3,119 个 Schema)。企业数据为私有业务数据,Pontx 不代理、缓存或聚合,调用方使用本地 SDK/CLI 直连。
请求
- operationId
driveFileSearch- 服务器
https://openapi.wps.cn- 认证
- app, delegated
请求参数
keyword
querystring
搜索关键词。
example-keyword
type
queryfile_search_type必填
file_type
queryenum_file_type
file_exts
queryarray
file exts。
drive_ids
queryarray
drive ids。
parent_ids
queryarray
parent ids。
creator_ids
queryarray
creator ids。
modifier_ids
queryarray
modifier ids。
sharer_ids
queryarray
sharer ids。
receiver_ids
queryarray
receiver ids。
time_type
querytime_type
start_time
queryintegerint64
开始时间(RFC3339)。
1
end_time
queryintegerint64
结束时间(RFC3339)。
1
with_permission
queryboolean
with permission。
true
with_link
queryboolean
with link。
true
with_total
queryboolean
with total。
true
page_size
queryintegerint64必填
每页返回条数。
1
page_token
querystring
分页起始令牌,不透明,应原样回传。
example-page-token
channels
queryarray
channels。
device_ids
queryarray
device ids。
exclude_channels
queryarray
exclude channels。
exclude_file_exts
queryarray
exclude file exts。
filter_user_id
queryintegerint64
filter user id。
1
file_ext_groups
queryarray
file ext groups。
with_folder
queryboolean
with folder。
true
with_drive
queryboolean
with drive。
true
order
queryenum_order
order_by
queryfile_search_enum_order_by
scope
queryfile_search_enum_scope
授权范围(scope)。
search_operator_name
queryboolean
search operator name。
true
X-Kso-Id-Type
headerid_type
响应
200
search_files_resp_bodyapplication/json
请求成功。
字段: data
default
unknownapplication/json
上游服务返回该状态。
{
"data": {
"items": {
"file": {},
"file_src": {},
"highlights": {},
"otime": 1
},
"next_page_token": "example-page-token",
"total": 1
}
}