新建文件（夹）

适用版本>=v7.0.2310a.20231019

接口说明：新建文件（夹）

请求说明

请求地址	配置域名+/graph+/v7/drives/{drive_id}/files/{parent_id}/create
请求方法	POST
签名方式	WPS-4签名/WPS-4-GM签名（配置域名+/graph不参与签名）
权限要求	更新文件（用户授权） kso.file.write 应用管理文件（应用授权） kso.appdrive.file.write

请求头（Header）

名称	是否必填	说明
Content-Type	是	固定为: application/json
Wps-Docs-Date	是	取当前时间， 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization	是	计算方法参考签名说明
Authorization	是	授权凭证，格式为: Bearer {access_token}

路径参数（Path）

名称	参数类型	是否必填	说明
drive_id	string	是	驱动盘id，<= 1024 characters
parent_id	string	是	文件（夹）id（根目录时为0），<= 1024 characters

请求体（Body）

名称	类型	是否必填	说明
file_type	string	是	文件类型，folder：文件夹；file：文件
name	string	是	文件名，须带上后缀，不支持"/:*?"<>|"特殊符号，长度范围[1,240]。例： abc.txt 支持格式后缀： 文字文件：doc,docx 表格文件：xls,xlsx 演示文件：ppt,pptx 多维表格：dbt，(需有多维表格组件集成权益) 轻文档：otl，(需有轻文档组件集成权益)
on_name_conflict	string	否	文件名冲突行为，fail：失败；rename：重命名；overwrite：覆盖；replace：替换。默认为rename

响应体（Response）

名称	类型	说明
data	object	新建文件（夹）信息返回
∟ id	string	文件id
∟ drive_id	string	驱动盘id
∟ parent_id	string	父文件id
∟ created_by	object	创建者信息
∟ ∟ avatar	string	创建者头像，<= 1024 characters
∟ ∟ company_id	string	创建者企业id，<= 1024 characters
∟ ∟ id	string	创建者id，<= 1024 characters
∟ ∟ name	string	创建者名称，<= 1024 characters
∟ ∟ type	string	创建者身份类型，user：用户；
∟ modified_by	object	修改者信息
∟ ∟ avatar	string	修改者头像，<= 1024 characters
∟ ∟ company_id	string	修改者企业id，<= 1024 characters
∟ ∟ id	string	修改者id，<= 1024 characters
∟ ∟ name	string	修改者名称，<= 1024 characters
∟ ∟ type	string	修改者身份类型，user：用户；
∟ size	int64	文件大小
∟ version	int	文件版本
∟ type	string	文件类型
∟ name	string	文件名称
∟ ctime	int64	文件创建时间，时间戳，单位为秒
∟ mtime	int64	文件修改时间，时间戳，单位为秒
∟ hash	object	文件哈希信息
∟ ∟ sum	string	哈希结果
∟ ∟ type	string	哈希类型，固定为s2s
∟ ext_attrs	object[]	文件扩展属性
∟ permission	object	文件权限
∟ link_url	string	分享链接
∟ link_id	string	分享链接id
code	integer	错误码，参照《错误码说明》
msg	string	状态信息
detail	string	详细信息

响应体示例

{
  "data": {
    "created_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "user"
    }，
    "ctime": 0,
    "drive_id": "string",
    "ext_attrs": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "hash": {
      "sum": "string",
      "type": "s2s"
    }，
    "id": "string",
    "link_id": "string",
    "link_url": "string",
    "modified_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "user"
    }，
    "mtime": 0,
    "name": "string",
    "parent_id": "string",
    "permission": {
      "comment": true,
      "copy": true,
      "copy_content": true,
      "delete": true,
      "download": true,
      "list": true,
      "move": true,
      "new_empty": true,
      "perm_ctl": true,
      "preview": true,
      "print": true,
      "rename": true,
      "share": true,
      "update": true,
      "upload": true
    }，
    "size": 0,
    "type": "folder",
    "version": 0
  }，
  "code": 0,
  "detail": "string",
  "msg": "string"
}