图片基本信息(imageInfo)

描述

图片基本信息包括图片格式、图片大小、色彩模型。
在图片下载URL后附加imageInfo指示符(区分大小写),即可获取JSON格式的图片基本信息。

请求

请求报文格式

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

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

示例: 资源为http://developer.qiniu.com/resource/gogopher.jpg,处理样式为imageInfo

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

请求头部

头部名称 必填 说明
Host 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

响应

响应报文格式

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

{
    "format":       "<ImageType         string>",
    "width":         <ImageWidth        int>,
    "height":        <ImageHeight       int>,
    "colorModel":   "<ImageColorModel   string>",
    "frameNumber":   <ImageFrameNumber  int>
}

响应头部

头部名称 必填 说明
Content-Type MIME类型,固定为application/json
Cache-Control 缓存控制,固定为no-store,不缓存

响应内容

■ 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):

{
    "format":       "<ImageType         string>",
    "width":         <ImageWidth        int>,
    "height":        <ImageHeight       int>,
    "colorModel":   "<ImageColorModel   string>",
    "frameNumber":   <ImageFrameNumber  int>
}
字段名称 必填 说明
format 图片类型,如png、jpeg、gif、bmp等。
width 图片宽度,单位:像素(px)。
height 图片高度,单位:像素(px)。
colorModel 彩色空间,如palette16、ycbcr等。
frameNumber 帧数,gif 图片会返回此项。

■ 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):

{
    "code":     <httpCode  int>, 
    "error":   "<errMsg    string>",
}
字段名称 必填 说明
code HTTP状态码,请参考响应状态码
error 与HTTP状态码对应的消息文本

响应状态码

HTTP状态码 含义
200 下载成功
400 请求报文格式错误
404 资源不存在
599 服务端操作失败。

如遇此错误,请将完整错误信息(包括所有HTTP响应头部)通过邮件发送给我们。

示例

  1. 获取图片基本信息:

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

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

    返回结果(内容经过格式化以便阅读)

    {
        "format":       "jpeg",
        "width":        640,
        "height":       427,
        "colorModel":   "ycbcr"
    }
    

内部参考资源


如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询