场景1: 指定returnBody
和returnUrl
,则返回跳转URL。
如:
bucket: image
key: 205.jpg
returnBody: bucket=$(bucket)&key=$(key)
returnUrl: http://www.abc.com
则返回给上传端内容为:
http://www.abc.com?bucket=image&key=205.jpg&hash=610d0284a0923298247d3a269ee28908cdcc7476
场景2:指定returnBody
,未指定returnUrl
,则返回returnBody
指定的内容。
returnBody
方便自定义返回给用户端的信息,当前可支持两种参数方式:自定义替换变量和特殊替换变量,两种方式可以随意组合使用。
注:
1、采用普通上传,默认返回文件hash值;采用分片上传,默认返回文件hash值及key;如果上传时设置了returnBody
,则返回内容中会增加returnBody
设置的内容
2、返回的内容为经过URL安全的Base64编码的字符串,为了更好说明,以下举例结果为经过解码的内容展示。
格式:$(x:variable)
范例:
returnBody: position=$(x:position)&message=$(x:message)
请求参数 position=abc&message=Success
普通上传返回给上传端内容为:
position=abc&message=Success&hash=610d0284a0923298247d3a269ee28908cdcc7476
分片上传返回给上传端内容为:
{
"position":"abc",
"message":"Success",
"key":"filename",
"hash":"610d0284a0923298247d3a269ee28908cdcc7476"
}
注:自定义变量必须是UTF-8格式,且不能含有&,否则会解析为乱码。
格式:$(variable)
范例:
returnBody:url=$(url)&fsize=$(fsize)&bucket=$(bucket)
url=http://abc.com/1.jpg
fsize=1231341
bucekt=test
普通上传返回给上传端内容为:
url=http://abc.com/1.jpg&fsize=1231341&bucket=test&hash=610d0284a0923298247d3a269ee28908cdcc7476
分片上传返回给上传端内容为:
{
"url":"http://abc.com/1.jpg",
"fsize":"1231341",
"bucekt":"test",
"key":"1.jpg",
"hash":"610d0284a0923298247d3a269ee28908cdcc7476"
}
注:指定的参数顺序也就是返回这些参数值结果的顺序。
特殊变量 | 描述 | 上传接口 |
---|---|---|
$(persistentId) | 上传预处理或者触发持久化处理的进程ID | 普通上传(分片上传受限使用) |
$(bucket) | 获得上传的目标空间名 | 普通上传/分片上传 |
$(key) | 获得文件保存在空间中的资源名 | 普通上传/分片上传 |
$(fname) | 上传的原始文件名 | 普通上传/分片上传 |
$(hash) | 资源的Etag | 普通上传/分片上传 |
$(fsize) | 资源尺寸,单位为字节(Byte) | 普通上传/分片上传 |
$(url) | 访问该资源的实际路径 | 普通上传/分片上传 |
$(ip) | 此次请求的来源IP | 普通上传/分片上传 |
$(imageInfo) | 上传图片的基本信息 | 普通上传/分片上传 |
$(exif) | 上传图片的exif信息 | 普通上传/分片上传 |
$(avinfo) | 视频元信息,格式为Json,经过URL安全的Base64编码 | 普通上传/分片上传 |
$(mimeType) | 资源类型,比如JPG图片的资源类型为image/jpg。 | 普通上传/分片上传 |