简单反馈只包含资源的基本信息,但很多情况下用户希望得到更多的资源信息。
在生成上传凭证时,开发者可以通过设置上传策略 (PutPolicy)中的ReturnBody
字段指定需要返回的信息,例如资源的大小、类型,图片的尺寸等等。
ReturnBody
实际上是用户定义的反馈信息模板,内容必须用JSON格式表达。下面是一个示例:
{
"foo": "bar",
"name": $(fname),
"size": $(fsize),
"type": $(mimeType),
"hash": $(etag),
"w": $(imageInfo.width),
"h": $(imageInfo.height),
"color": $(exif.ColorSpace.val)
}
用户可以在ReturnBody
中使用魔法变量和自定义变量。七牛云存储会将这些变量替换为对应实际值,然后作为响应内容反馈给用户,如下所示:
{
"foo": "bar",
"name": "gogopher.jpg",
"size": 214513,
"type": "image/jpg",
"hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
"w": 640,
"h": 480,
"color": "sRGB"
}
**注意:**如果上传策略 (PutPolicy)中通过设置callbackUrl
字段启用了回调,ReturnBody
将直接被忽略。
在回调模式中如果也想自定义响应内容,请在生成上传凭证时设置上传策略中的callbackBody
字段。更多关于回调模式的解释,请参考回调通知 (callback)。
文档反馈
(如有产品使用问题,请 提交工单)