资源工坊

基于模板新建文件 ​

适用版本>=v7.0.2502b.20250227

接口说明：基于模板新建文件

请求说明 ​

请求地址配置域名+/openapi+/v7/kdocs/templates/{template_id}/new_file
请求方法POST
签名方式KSO-1（配置域名+/openapi不参与签名）
权限要求查询和管理模板库文件（应用授权） kso.kdocs_template.readwrite

请求头（Header） ​

Header参数类型是否必填说明
Content-Typestring是使用：application/json
X-Kso-Datestring是RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorizationstring是KSO-1 签名值，详见《签名方法》
Authorizationstring是授权凭证，格式为：Bearer {access_token}

路径参数（Path） ​

名称参数类型是否必填说明
template_idstring是模板id

请求体（Body） ​

名称类型是否必填说明
dst_drive_idstring是目标盘id
dst_parent_idstring是目标文件夹id，根目录时为0

响应体（Response） ​

名称类型说明
dataobject新建文件（夹）信息返回
∟ idstring文件id
∟ drive_idstring驱动盘id
∟ parent_idstring父文件id
∟ created_byobject创建者信息
∟ ∟ avatarstring创建者头像，<= 1024 characters
∟ ∟ company_idstring创建者企业id，<= 1024 characters
∟ ∟ idstring创建者id，<= 1024 characters
∟ ∟ namestring创建者名称，<= 1024 characters
∟ ∟ typestring创建者身份类型，sp：应用；
∟ modified_byobject修改者信息
∟ ∟ avatarstring修改者头像，<= 1024 characters
∟ ∟ company_idstring修改者企业id，<= 1024 characters
∟ ∟ idstring修改者id，<= 1024 characters
∟ ∟ namestring修改者名称，<= 1024 characters
∟ ∟ typestring修改者身份类型，sp：应用；
∟ sizeint64文件大小
∟ versionint文件版本
∟ typestring文件类型
∟ namestring文件名称
∟ ctimeint64文件创建时间，时间戳，单位为秒
∟ mtimeint64文件修改时间，时间戳，单位为秒
∟ sharedboolean是否开启分享
∟ hashobject文件哈希信息
∟ ∟ sumstring哈希结果
∟ ∟ typestring哈希类型，固定为s2s
∟ ext_attrsobject[]文件扩展属性
∟ permissionobject文件权限
∟ link_urlstring分享链接
∟ link_idstring分享链接id
codeint错误码
msgstring状态信息
detailstring详细信息

响应体示例 ​

json
{
  "data": {
    "created_by": {
      "avatar": "string",
      "company_id": "string",
      "id": "string",
      "name": "string",
      "type": "sp"
    },
    "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": "sp"
    },
    "mtime": 0,
    "name": "string",
    "shared": false,
    "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": "file",
    "version": 0
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}