文件上传接口

最近更新时间:2018-10-30 11:00:00

接口名称:upload

接口url:https://upload-ess.xycloud.com/upload

描述:upload 用于文件上传

字段传递方式:参数方式传递

请求参数

名称 类型 是否必须 描述
bucket string Yes 用户自己创建的存储 bucket,缺失时返回 403
filesize int Yes 上传文件大小,缺失时返回 403
uri string Yes 文件的唯一标识(重复则覆盖),格式为 test.com/dir/test.txt
,注意开始位置不带'/'
expiretime int Yes 期望上传文件在 ESS 存储中保存的过期时间
sign string Yes 用户 token 值,生成规则:MD5(ak + sk + ct + bucket + filesize + uri + expirestime + mcheck)
ak string Yes 用户创建时返回的 ak/sk ,用于 token 验证
mcheck string Yes 文件内容 md5,用于计算内容是否正确

返回参数

名称 类型 是否必须 描述
errno int 状态码:0 正常,非 0 异常
errmsg string 错误信息:OK/错误原因

示例

请求示例

POST /upload?bucket=bucket&filesize=35&uri=/test.com/dir/test.txt&expiretime=0&sign=6b883e99c162b33221c2f696518fbf59&mcheck=1ca423592943cc8bde88c2fe7d8031e0&ct=1537349037&ak=ak HTTP/1.1
Host: upload-ess.xycloud.com
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.19.1
Content-Length: 179
Content-Type: multipart/form-data; boundary=d6814940f7b027bad63253ec4fd30b08

--d6814940f7b027bad63253ec4fd30b08
Content-Disposition: form-data; name="file"; filename="test.txt"

sdvfdbshobhrdngbndfbsndfbihrtdnvsh

--d6814940f7b027bad63253ec4fd30b08--

返回示例

HTTP/1.1 200 OK
Server: openresty
Date: Wed, 19 Seq 2018 09:23:53 GMT
Content-Type: text/plain
Connection: keep-alive
Access-Control-Allow-Methods: GET,POST,OPTIONS,HEAD
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: *
Access-Control-Allow-Origin: *
Content-Length: 26

{"errno":0, "errmsg":"OK"}