全部产品
云市场

获取图片信息

更新时间:2019-03-26 20:07:47

描述

通过图片ID获取图片的基本信息,包括图片标题、类型、创建时间、标签等。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetImageInfo
ImageIdString图片ID
AuthTimeoutLong图片地址过期时间,单位:秒。
如果返回的是CDN加速地址:
  • 只有开启了URL鉴权图片地址才会定期失效,否则会永久有效。
  • 最小值:1
  • 最大值:无限制
  • 默认值:未设置时,取值为URL鉴权中设置的默认有效时长
如果返回的是OSS源站地址:
  • 只有存储权限为私有,播放地址才会定期失效,否则会永久有效
  • 最小值:1
  • 最大值:为降低源站安全风险,最大值为2592000(即30天)
  • 默认值:未设置时,取值为3600
OutputTypeString输出地址类型。取值范围 :
  • oss(回源地址)
  • cdn(加速地址)
默认为cdn类型。

返回参数

名称类型描述
RequestId String请求ID
ImageInfo ImageInfo图片信息

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetImageInfo&ImageId=3e34733b40bd46719a96ccf5c1ff6f69&Format=JSON&<公共参数>

注意:示例中的“公共参数”参见 公共参数说明文档

返回示例

JSON格式

  1. {
  2. "RequestId": "5FFCED85-7ACD-4D62-A533-20A59AXXXXX",
  3. "ImageInfo": {
  4. "Description": "测试描述",
  5. "Mezzanine": {
  6. "OriginalFileName": "xxxxx.gif",
  7. "Height": 200,
  8. "Width": 200,
  9. "FileSize": 8932
  10. },
  11. "CreationTime": "2018-11-21T02:37:23Z",
  12. "ImageId": "xxxxxxxxxxxxxxxxxxxx",
  13. "Title": "this is a sample",
  14. "CateId": 254766071,
  15. "CateName": "测试",
  16. "StorageLocation": "sample.oss-cn-shanghai.aliyuncs.com",
  17. "Tags": "标签1,标签2,tag1,tag2,tag3",
  18. "URL": "http://sample.com/image/default/xxxxx.gif?auth_key=xxxx",
  19. "ImageType": "default"
  20. }
  21. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码列表

错误代码错误信息HTTP 状态码说明
NoSuchResourceThe specified resource does not exist.404图片不存在。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: