简要描述:

  • 上传文件。

接口版本:

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

请求URL:

请求参数:

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

请求示例:

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

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

返回示例:

正常返回:

{"code":200,"exists":0,"upload_url":"https:\/\/upload-ctc.ctfile.com\/web\/public_client_upload.do?hash=a8cc5eec460046decffa9945f30faf8c&session=41e20167a3b05a21c47265dd3c262c92"}

错误时返回:

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

返回参数说明:

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

上传文件至服务器(PUT方式上传stream):

请求参数说明:

参数名 类型 说明
hash string 当前文件对应的临时编号
filesize int 文件大小
path string 文件名
folderid int 上传的文件夹ID,去掉前面d
contentlength int 当前片段大小,适用于续传

请求:

PUT /web/public_client_upload.do?hash=a8cc5eec460046decffa9945f30faf8c&session=41e20167a3b05a21c47265dd3c262c92&path=001.zip&filesize=12954629123&folderid=0&contentlength=12954629123 HTTP/1.1
HOST: upload.ctfile.com

返回:

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

获取上传状态(已上传的数据大小):

请求:

GET /web/public_client_upload.do?hash=a8cc5eec460046decffa9945f30faf8c&session=41e20167a3b05a21c47265dd3c262c92 HTTP/1.1
HOST: upload.ctfile.com
content-type: application/json

返回:

{
"code": 200,
"filesize": 0
}

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-09-03 18:33   作者:admin