简要描述：

  • 上传文件。

接口版本：

版本号 制定人 制定日期 修订日期
1.0 Joe 2020-05-20 2020-05-20

请求URL:

请求参数:

参数名 是否必须 类型 说明
folder_id 是 string 目标文件夹ID
checksum 是 string 预计算特征值
size 是 long 文件大小
name 是 string 文件名

请求示例:

POST /v1/private/file/upload HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 200

{
  "session": "ff6cf1d8b56c41d1da684ea3bc3df6eb",
  "folder_id": "d0",
  "checksum ": "f5081fd170cc05ca8357205baa28b123-12954629123",
  "size ": "12954629123",
  "name" : "hello internet.iso"
}

返回示例:

正常返回:

{"code":200,"exists":0,"upload_url":"https:\/\/upload.ctfile.com\/web\/privateUpload.do?userid=123456&maxsize=2147483648&folderid=123456&ctt=1636181597&limit=2&spd=23000000&key=ec5b213ffew3789d312321312sdwe"}

错误时返回:

{"code":403,"message":"错误描述"}

返回参数说明:

参数名 类型 说明
exists int 1，为服务器已存在相同特征码的文件，无需再次上传。 0，为服务器不存在相同特征码文件，需要上传。
upload_url string 文件上传的url

上传文件至服务器（上传链接获取一次后可反复使用24小时）：

请求参数说明（Form Data）:

参数名 类型 说明
name string 文件名
filesize int 文件大小
file file 文件内容

请求（必须以multipart/form-data方式）:

POST /web/privateUpload.do?userid=123456&maxsize=2147483648&folderid=123456&ctt=1636181597&limit=2&spd=23000000&key=ec5b213ffew3789d312321312sdwe HTTP/1.1
HOST: upload.ctfile.com
content-type: multipart/form-data;

返回:

{
"code": 200,
"message": "done"
}

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-11-04 15:22   作者：admin