Skip to content

整文件上传

适用版本>=v7.0.2509.20250925

接口说明:整文件上传

请求说明

请求地址配置域名+/openapi+/v7/appfiles/drives/{drive_id}/files/{parent_id}/upload
请求方法POST
签名方式KSO-1(配置域名+/openapi不参与签名)
权限要求应用身份管理文档(应用授权) kso.appfiles.readwrite

请求头(Header)

Header参数类型是否必填说明
X-Kso-DatestringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-AuthorizationstringKSO-1 签名值,详见《签名方法》
Authorizationstring授权凭证,格式为:Bearer {access_token}

路径参数(Path)

名称类型是否必填说明
drive_idstring驱动盘id,长度不超过1024位
parent_idstring父目录id(应用文档为0)

查询参数(Query)

名称类型是否必填说明可选值
namestring文件名-
sizeinteger本节点文件大小(不包含附件,单位字节)-
file_idstring文件id-
_w_third_user_idstring操作者id-

响应体(Response)

名称类型说明
dataobject
created_byobject创建者信息
idstring身份ID
typestringEnum: "user" "sp",身份类型
ctimeinteger创建时间,时间戳,单位为秒
drive_idstring驱动盘id
idstring文件id
link_idstring链接id(应用文档:忽略此参数)
link_urlstring链接url(应用文档:忽略此参数)
modified_byobject修改者信息
idstring身份ID
typestringEnum: "user" "sp",身份类型
mtimeinteger修改时间,时间戳,单位为秒
namestring文件名
parent_idstring父目录id(应用文档:0)
sharedboolean是否开启分享(应用文档:false)
sizeinteger文件大小
typestringEnum: "folder" "file";文件类型(应用文档:file)
versioninteger文件版本号
codeint错误码
msgstring状态信息
detailstring详细信息

响应体示例

json
{
  "data": {
    "created_by": {
      "id": "string",
      "type": "sp"
    },
    "ctime": 1695638400,
    "drive_id": "string",
    "id": "string",
    "link_id": "string",
    "link_url": "string",
    "modified_by": {
      "id": "string",
      "type": "sp"
    },
    "mtime": 0,
    "name": "string",
    "parent_id": "string",
    "shared": false,
    "size": 0,
    "type": "file",
    "version": 0
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}