图片主色调（imageAve）

• 描述
• 请求
  • 请求报文格式
  • 请求头部
• 响应
  • 响应报文格式
  • 响应头部
  • 响应内容
  • 响应状态码
• 附注
• 示例
• 内部参考资源

描述

本接口用于计算一幅图片的平均色调，并以0xRRGGBB形式返回。

请求

请求报文格式

GET <ImageDownloadURI>?imageAve HTTP/1.1
Host: <ImageDownloadHost>

注意：当您下载私有空间的资源时，ImageDownloadURI的生成方法请参考七牛的下载凭证。

示例： 资源为http://developer.qiniu.com/resource/gogopher.jpg，处理样式为imageAve。

#构造下载URL
DownloadUrl = 'http://developer.qiniu.com/resource/gogopher.jpg?imageAve'
……
#最后得到
RealDownloadUrl = 'http://developer.qiniu.com/resource/gogopher.jpg?imageAve&e=×××&token=MY_ACCESS_KEY:×××'

请求头部

响应

响应报文格式

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

{
    "RGB": "<ImageAve string>"
}

响应头部

响应内容

■ 如果请求成功，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    "RGB": "<ImageAve string>"
}

■ 如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    "code":     <httpCode  int>, 
    "error":   "<errMsg    string>",
}

响应状态码

附注

• 缩略图等经过云处理的新图片不支持该方法。
  

示例

1. 获取图片主色调：

   在Web浏览器中输入以下图片地址

   http://developer.qiniu.com/resource/gogopher.jpg?imageAve
   

   返回结果（内容经过格式化以便阅读）

   {
       "RGB": "0x85694d"
   }