功能概述
腾讯云数据万象通过 imageInfo 接口查询图片基本信息，包括格式、长、宽等。
授权说明
服务开通
使用该功能将默认为您开通数据万象，并绑定存储桶，无需角色授权，即可直接使用。
使用限制
费用说明
该接口将产生 基础图片处理费用。
通过外网使用时，调用会产生 流量费用，流量大小为返回的 json 响应体。
接口示例
GET /<ObjectKey>?imageInfo HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
处理参数说明
请求参数
参数 | 含义 | 类型 | 是否必填 |
ObjectKey | 对象文件名，例如 folder/sample.jpg。 | String | 是 |
imageInfo | 该参数无其他值，为固定值，表示查询图片基本信息。 | String | 是 |
响应体
参数 | 含义 | 类型 |
format | 图片类型，例如 png、gif 等， | String |
width | 图片的宽度，单位为像素（px）。 | String |
height | 图片的高度，单位为像素（px）。 | String |
size | 图片的大小，单位为 Bytes。 | String |
md5 | 图片的 md5 值。 | String |
dynamic_range | 图片是否为 hdr，有效值：hdr、gainmap hdr、sdr、unknow。 | String |
frame_count | 图片的帧数，静态图为1，动图为对应的帧数。 | String |
bit_depth | 图片的位深。 | String |
vertical_dpi | 图片的垂直分辨率。 | String |
horizontal_dpi | 图片的水平分辨率。 | String |
实际案例
案例一：公有读
请求
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageInfo
响应
{"format": "jpeg", "width": "960", "height": "540", "size": "158421", "md5": "77a16fa70e2eba652fb42e8a639c52f2","dynamic_range": "unknow", "frame_count": "1", "bit_depth": "8", "vertical_dpi": "118", "horizontal_dpi": "118"}
案例二：私有读、携带签名
获取方式同上，仅增加签名部分，并与获取参数以“&”连接，示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&imageInfo
说明：
注意事项
为了避免未授权人员通过访问不携带处理参数的链接实现访问和下载原图的情况，您可同时将处理参数签入到请求签名中，处理参数整体是参数的 key，value 为空，如下是简单的示例（仅做样式参考，可能已经过期无法直接访问），详细计算方法请参见 请求签名。
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=****************************************&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
