普通上传

普通上传接口提供了将资源文件上传到对象存储平台指定bucket的功能。如果文件大小大于500MB，必须使用分片上传。普通上传还支持通过HTML表单进行上传。

注意：

1. 分片上传建议的文件大小因环境而异。请参考相关SDK中提供的建议值。
2. 对象存储提供的上传域名是普通域名。

请求说明

上传请求以 HTTP multipart/form-data 格式组织提交。示例如下：

POST /file/upload HTTP/1.1
Host: <UploadDomain>
Accept: */*
Content-Type: multipart/form-data; boundary=<boundary>
Content-Length: <multipartContentLength>
--<boundary>
Content-Disposition: form-data; name="token"
<uploadToken>
--<boundary>
Content-Disposition: form-data; name="<x:VariableName>"
<x:VariableValue>
--<boundary>
Content-Disposition: form-data; name="key"
<key>
--<boundary>
Content-Disposition: form-data; name="mimeType"
<mimeType>
--<boundary>
Content-Disposition: form-data; name="deadline"
<deadline>
--<boundary>
Content-Disposition: form-data; name="file"; filename="original file name"
Content-Type: application/octet-stream
<fileBinaryData>
--<boundary>--

Header 说明

参数说明

响应说明

成功响应 (200 OK)

HTTP/1.1 200 OK
    Server: WS-web-server
    <ResponseContent>

如果请求成功， 将是以下内容的URL安全Base64编码字符串，解码后的核心内容结构为：

hash=<filehash>

核心字段说明：

注意：如果在上传时定义了returnBody，returnBody的内容将被添加到返回内容中，例如 name=&size=hash=。此时 hash 字段会集成在 returnBody 的返回值中。

错误响应

请求失败时， ​​是一个 JSON 格式的字符串​​，包含以下字段：

{
    "code":     "<code string>",
    "message":  "<message string>"
}

错误字段说明：

调用示例

curl -v -i -X POST -H "Expect:" -F file=@D:/8.png -F key=m.png -F token="6a69ab4062cb03059e4c13a0f5e662523effad49:ZGE1MWY1YzA4ZDgyMjVlM2Q3MmE2YjZkZDI3MmY1ZmMxNjk2YTFjOA==:eyJzY29wZSI6InRlc3QiLCJkZWFkbGluZSI6IjE0NzIxNzY2MzQwMDAiLCJvdmVyd3JpdGUiOjAsImZzaXplTGltaXQiOjAsImluc3RhbnQiOjAsInNlcGFyYXRlIjowfQ==" --url 'http://updomain.com/file/upload'