全部产品
云市场

获取图片上传地址和凭证

更新时间:2019-04-11 12:17:27

描述

获取图片上传地址和凭证。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值: CreateUploadImage
ImageTypeString图片类型。取值范围:
  • default(默认)
  • cover(封面)
控制台暂时只支持default类型的图片管理
ImageExtString图片文件扩展名。取值范围:
  • png
  • jpg
  • jpeg
  • gif
默认值:png
TitleString图片标题。规则:
  • 长度不超过128个字节。
  • UTF8编码。
TagsString图片标签。规则:
  • 单个标签不超过32字节。
  • 最多不超过16个标签。
  • 多个用逗号分隔。
  • UTF8编码。
CateIdLong分类ID。
请在 点播控制台 > 全局设置 > 分类管理 编辑或查看分类的ID。
DescriptionString图片描述。
  • 长度不超过1024个字节。
  • UTF8编码。
StorageLocationString存储地址。当不为空时,会使用该指定的存储地址上传图片文件。可在 点播控制台 > 存储管理 里查看存储地址。
UserDataUserData自定义设置,为JSON字符串,支持消息回调等设置。
AppId String应用ID。取值如:app-1000000。使用说明参考文档 多应用

返回参数

名称类型描述
RequestId String 请求ID。
UploadAddressString 上传地址。
UploadAuth String 上传凭证。
ImageURL String 图片地址。
ImageId String 图片ID。

注意:

  • 该接口不会真正上传图片文件,您需在获得上传凭证和地址后,使用上传SDK进行文件上传(和视频上传相同)。
  • 图片水印通过 获取辅助媒资上传地址和凭证 接口上传。
  • 如果图片上传凭证失效(有效期3000秒),请重新调用此接口获取上传地址和凭证。
  • 如果返回的ImageURL在浏览器无法访问(403),是因为您开启了点播域名的鉴权功能。可关闭 URL鉴权 或自助 生成鉴权签名
  • 更多使用说明参考 上传地址和凭证

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=CreateUploadImage&ImageType=cover&Format=JSON&<公共参数>

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

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "ImageId": "93ab850b4f6f44eab54b6e91d24d81d4",
  4. "UploadAddress": "eyJTZWN1cml0eVRva2VuIjoiQ0FJU3p3TjF",
  5. "UploadAuth": "eyJFbmRwb2ludCI6Im",
  6. "ImageURL": "http://aliyun.com/cover/2017-06-20-20-42-48_86DB3A58-08FB-4F4C-9373-003AA06012EA.png"
  7. }

SDK示例

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