千问办公企业旗舰版开发者文档:查询目录元信息。
认证方式见APP开发者文档 → 认证接入。
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
200 无响应体。HEAD 只读取响应元信息,不返回 JSON 响应体。
401 表示认证失败,403 表示资源权限拒绝;400/422 表示参数无效,404 表示当前用户资源不存在,409 表示冲突。依赖故障保持原错误,不伪造成功;503 为维护或依赖不可用,504 为请求超时。写操作结果未知时先查询资源状态,不盲目重复执行。
- 模块:文件
- 接口:HEAD
/api/openapi/app/v1/drive/directories/{path} - operationId:
app-head-directories-path
接口说明
当前用户身份由 IAM 验证,Barn 执行文件归属与业务校验。不使用管理 API Key、Agent Token 或 OAuth 凭据替代,不自行设置 X-Gw 身份头。
请求参数
| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| path | path | string | 是 | 目录/复制为整个 URL 编码的绝对逻辑路径;文件/Office 为 query 路径 |
| limit | query | integer | 否 | 非负整数;默认 100,1~1000 按指定数量读取,0 或大于 1000 时按 100 处理。 |
| offset | query | integer | 否 | 非负整数,默认 0,表示跳过的记录数量。 |
| sort | query | string | 否 | file(按路径,默认)、modified(修改时间)、created(创建时间);不区分大小写。 |
| order | query | string | 否 | asc(默认)或 desc;不区分大小写。 |
| include | query | string | 否 | 省略、空值或 display_name;当前保留参数兼容,但不补充 display_name。 |