返回数据说明

场景1: 指定returnBodyreturnUrl,则返回跳转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。 普通上传/分片上传