Skip to main content

创建网盘目录

千问办公企业旗舰版开发者文档:创建网盘目录。

认证方式见APP开发者文档 → 认证接入。
  • 模块:文件
  • 接口:POST/api/openapi/app/v1/drive/directories/{path}
  • operationId:app-post-directories-path

接口说明

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

请求参数

字段位置类型必填说明
pathpathstring是目录/复制为整个 URL 编码的绝对逻辑路径;文件/Office 为 query 路径
metadatabodyobject否JSON 请求字段

响应

201 返回裸 JSON 对象。

响应字段

字段类型必返约束说明
created_atstring是date-time创建时间,RFC 3339。
display_namestring否—服务端提供的展示名称,可能省略。
file_idstring是uuid当前用户网盘中的稳定文件/目录 UUID;重命名不改变,复制生成新 ID。
is_directoryboolean是—是否为目录。
metadataobject<string, string>是—字符串键值元数据;无元数据时为 {}。
mime_typestring是—MIME 类型;目录为 application/x-directory。
moderation_statestring否—文件审核状态;未提供时不应推断审核已通过。
modified_atstring是date-time最后修改时间,RFC 3339。
pathstring是—当前用户可见的绝对逻辑路径。
presigned_urlstring否—临时访问 URL,可能省略;原样使用,不附带登录凭据。
sizeinteger是int64大小,单位字节;目录按服务端累计大小返回。
sourcestring是—服务端记录的文件来源,不由客户端据此判断权限。
storage_pathstring否—带隔离前缀的逻辑存储路径,不是 OSS 对象 key;仅部分响应提供。

错误处理

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