图片基本信息(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响应头部)通过邮件发送给我们。 |
示例
获取图片基本信息:
在Web浏览器中输入以下图片地址
http://developer.qiniu.com/resource/gogopher.jpg?imageInfo
返回结果(内容经过格式化以便阅读)
{ "format": "jpeg", "width": 640, "height": 427, "colorModel": "ycbcr" }
如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询