获取图片信息 - 视频点播

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


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

返回数据


名称	类型	示例值	描述
RequestId	String	AB99D4DF-FAFA-49*****DC-9C548C1E261E	请求ID。
ImageInfo	Object		图片信息。
CreationTime	String	2018-11-21T02:37:23Z	图片创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
StorageLocation	String	sample.oss-cn-shanghai.aliyuncs.com	文件存储区域。
Status	String	Uploading	图片状态。取值： Uploading：初始状态，表示图片正在上传。 Normal：图片上传成功。 UploadFail：图片上传失败。
CateId	Long	254766071	分类ID。
Tags	String	tag1,tag2,tag3	图片标签。多个使用英文逗号（,）隔开。
ImageType	String	default	图片类型。取值： CoverSnapshot：封面截图。 NormalSnapshot：普通截图。 SpriteSnapshot：雪碧截图。 SpriteOriginSnapshot：雪碧图原始图。 All（以上多种类型的图片）：非All时支持多个类型，使用英文逗号（,）分隔传入。
CateName	String	测试	分类名称。
Description	String	测试描述	描述。
AppId	String	app-****	应用ID。
URL	String	http://sample.com/image/default/**.gif?auth_key=**	图片URL（如果配置了CDN域名则为CDN地址，否则为OSS地址）。
Title	String	this is a sample	图片标题。
ImageId	String	bbc65bba53f9*****ed90de118a7849	图片ID。
Mezzanine	Object		图片源信息。
FileURL	String	https://outin-bfefbb***163e1c7426.oss-cn-shanghai.aliyuncs.com/image/default/5E84CD536*D4DAD.png?Expires=1590982353&OSSAccessKeyId=*&Signature=ALPET74o***c%3D	图片OSS URL。
OriginalFileName	String	****.gif	上传文件名称。
Width	Integer	200	图片宽度。单位：像素。
Height	Integer	200	图片高度。单位：像素。
FileSize	String	8932	文件大小。单位：字节。

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetImageInfo
&ImageId=3e34733b40b*****9a96ccf5c1ff6f69
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetImageInfoResponse>
    <RequestId>AB99D4DF-FAFA-49*****DC-9C548C1E261E</RequestId>
	<ImageInfo>
		<Description>测试描述</Description>
		<Mezzanine>
			<OriginalFileName>https://outin-bfefbb*****163e1c7426.oss-cn-shanghai.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D</OriginalFileName>
			<Height>200</Height>
			<Width>200</Width>
			<FileSize>8932</FileSize>
		</Mezzanine>
		<CreationTime>2018-11-21T02:37:23Z</CreationTime>
		<ImageId>bbc65bba53f9*****ed90de118a7849</ImageId>
		<Title>this is a sample</Title>
		<CateId>254766071</CateId>
		<CateName>测试</CateName>
		<StorageLocation>outin-bfefbb*****163e1c7426.oss-cn-shanghai.aliyuncs.com</StorageLocation>
		<Tags>tag1,tag2,tag3</Tags>
		<URL>https://al*****.cn/image/default/5E84CD536*****D4DAD.png?auth_key=159098055*****70a396e834</URL>
		<ImageType>default</ImageType>
	</ImageInfo>
</GetImageInfoResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "AB99D4DF-FAFA-49*****DC-9C548C1E261E",
  "ImageInfo" : {
    "Description" : "测试描述",
    "Mezzanine" : {
      "OriginalFileName" : "https://outin-bfefbb*****163e1c7426.oss-cn-shanghai.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
      "Height" : 200,
      "Width" : 200,
      "FileSize" : 8932
    },
    "CreationTime" : "2018-11-21T02:37:23Z",
    "ImageId" : "bbc65bba53f9*****ed90de118a7849",
    "Title" : "this is a sample",
    "CateId" : 254766071,
    "CateName" : "测试",
    "StorageLocation" : "outin-bfefbb*****163e1c7426.oss-cn-shanghai.aliyuncs.com",
    "Tags" : "tag1,tag2,tag3",
    "URL" : "https://al*****.cn/image/default/5E84CD536*****D4DAD.png?auth_key=159098055*****70a396e834",
    "ImageType" : "default"
  }
}

错误码

访问错误中心查看更多错误码。

接口错误码

下表列举了本接口特有的错误码。


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

SDK示例

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