调用CreateUploadImage获取图片上传地址和凭证。
接口说明
使用说明
- 获取上传地址和凭证为点播服务的核心基础,是每个上传操作的必经过程。点播服务提供了服务端上传SDK、客户端上传SDK、离线拉取上传、基于OSS服务端API上传、基于OSS原生SDK上传等不同的上传方式,每种方式对获取上传地址和凭证的要求不同,详细内容请参见上传地址和凭证的使用说明。
- 上传图片不支持刷新上传地址和凭证。如果图片上传凭证失效( 默认有效期3000秒),请重新调用此接口获取上传地址和凭证。
- 图片水印通过获取辅助媒资上传地址和凭证接口上传。
- 可通过配置回调,接收图片上传完成的事件通知来判断是否上传成功。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Title | string | 否 | 图片标题。规则:
| mytitle |
ImageType | string | 是 | 图片类型。取值:
说明控制台暂时仅支持default类型的图片管理。 | default |
ImageExt | string | 否 | 图片文件扩展名。取值:
| png |
Tags | string | 否 | 图片标签。规则:
| 测试 |
StorageLocation | string | 否 | 存储地址。可通过以下方式获取: 登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理查看存储地址。 说明当地址不为空时,会使用该指定的存储地址上传视频文件。 | outin-****..oss-cn-shanghai.aliyuncs.com |
CateId | Long | 否 | 100036**** | |
UserData | string | 否 | {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} | |
Description | string | 否 | 图片描述。
| 图片上传测试 |
AppId | string | 否 | 应用ID。默认取值:app-1000000。更多信息,请参见多应用。 | app-1000000 |
返回参数
示例
请求示例
http(s)://vod.cn-shanghai.aliyuncs.com/?Action=CreateUploadImage
&Title=mytitle
&ImageType=default
&ImageExt=png
&Tags=测试
&StorageLocation=outin-****..oss-cn-shanghai.aliyuncs.com
&UserData={"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
&Description=图片上传测试
&AppId=app-1000000
&公共请求参数
正常返回示例
JSON
格式
{
"FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
"RequestId": "25818875-5F78-AEF6-D7393642****",
"UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
"ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
"ImageId": "93ab850b4f6f46e91d24d81d4****",
"UploadAuth": "eyJFbmmRCI6Im****"
}
XML
格式
<CreateUploadImageResponse>
<FileURL>http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png</FileURL>
<RequestId>25818875-5F78-AEF6-D7393642****</RequestId>
<UploadAddress>eyJTZWN1cmuIjoiQ0FJU3p3TjF****</UploadAddress>
<ImageURL>http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png</ImageURL>
<ImageId>93ab850b4f6f46e91d24d81d4****</ImageId>
<UploadAuth>eyJFbmmRCI6Im****</UploadAuth>
</CreateUploadImageResponse>
错误码
访问错误中心查看更多错误码。