图片基本信息(imageInfo)
图片基本信息包括图片格式、图片大小、色彩模型。
在图片下载URL后附加imageInfo
指示符(区分大小写),即可获取JSON格式的图片基本信息。
请求报文
请求语法
GET <imageDownloadUri>?imageInfo HTTP/1.1
Host: <imageDownloadHost>
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程。 |
响应报文
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
"size": "<ImageSize int>",
"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字符串(已格式化,便于阅读):
{
"size": "<ImageSize int>",
"format": "<ImageType string>",
"width": <ImageWidth int>,
"height": <ImageHeight int>,
"colorModel": "<ImageColorModel string>",
"frameNumber": <ImageFrameNumber int>
}
字段名称 | 必填 | 说明 |
---|---|---|
size | 是 | 文件大小,单位:Bytes |
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://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageInfo
返回结果(内容经过格式化以便阅读):
{
size: 214513,
format: "jpeg",
width: 640,
height: 427,
colorModel: "ycbcr",
orientation: "Top-left"
}
文档反馈
(如有产品使用问题,请提交工单)