对象存储 > 使用指南 > 开发指南 > 上传资源 > 自定义响应内容

自定义响应内容

最近更新时间: 2021-05-14 18:38:12

简单反馈只包含资源的基本信息，但很多情况下用户希望得到更多的资源信息。

在生成上传凭证时，开发者可以通过设置上传策略 (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)。

以上内容是否对您有帮助？