Skip to main content

查询搜索响应元信息

千问办公企业旗舰版开发者文档:查询搜索响应元信息。

认证方式见APP开发者文档 → 认证接入。
  • 模块:文件
  • 接口:HEAD/api/openapi/app/v1/drive/search
  • operationId:app-head-search

接口说明

当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。

请求参数

字段位置类型必填说明
qquerystring否搜索关键词;须与 q_type 一起提供才执行查询,显式 q= 允许空关键词。
q_typequerystring否filename 或 name;须与 q 一起提供。
file_typequerystring否可省略;非空时接受以 image、video、audio、document 开头的分类值,其他值拒绝。
limitqueryinteger否非负整数;默认 100,1~1000 按指定数量读取,0 或大于 1000 时按 100 处理。
offsetqueryinteger否非负整数,默认 0,表示跳过的记录数量。

响应

200 无响应体。HEAD 只读取响应元信息,不返回 JSON 响应体。

错误处理

401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。