获取图片信息_图片管理_媒资管理_服务端API

描述

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

请求参数

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

返回参数

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

API示例

请求示例

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

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

返回示例

JSON格式

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

错误码

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

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

SDK示例

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