文件上传接口

最近更新时间：2023-07-25

接口名称：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"}