创建上传任务

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 创建上传任务
返回格式 Json,UTF8
HTTP请求方式 POST
当前接口版本 V3
历史接口版本

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.video.upload.create
client_id client_id true String 应用的client id
access_token access token true String oauth2的token
sign_method sign_method false String 签名的摘要算法,可选值为:HmacSHA256,md5。默认为md5
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String 3.0
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数类型 必选 默认值 参数描述
client_ip int true 视频上传者的IP
server_type string true oupload表示oss direct, oss使用方法详见阿里云oss sdk文档(https://help.aliyun.com/document_detail/32013.html?spm=a2c4g.11186623.6.706.27296e84w1h4ub)
file_name string true 视频文件名(包含扩展名)
file_size string true 视频文件大小(当参数app_id为1或者10020时,该参数为必选) (单位:字节)
file_md5 string false 视频文件MD5,如果MD5与上传文件MD5不一致将导致失败。 web上传可以不填
duration double false ’original’ 视频时长(单位:秒)

4. 返回参数

参数名 参数类型 允许为空 参数描述
vid String true 创建的视频ID
upload_token String true 上传token,每个上传任务的唯一标识
endpoint string true oss endPoint
security_token string true sts token
oss_bucket string true oss bucket名字
oss_object string true oss key 上传时临时文件的名字
temp_access_id string true 临时ak
temp_access_secret string true 临时ak秘钥
expire_time string true 临时ak过期时间

5. 调用示例

调用示例:
http://openapi.youku.com?opensysparams={"access_token":"a35c5e97ab67efcf225b23a2f610228f",
"action":"youku.video.upload.create","client_id":"84292d14de7ac6c6",
"sign_method":"md5","timestamp":"1491569838","version":"3.0",
"sign":"0de40f9919ad831fbbd85c9241e2bc01"}&client_ip=106.11.34.25&file_md5=6D14D717DC5589C80C7DF37D350E8D59
&file_name=C%3A%2FUsers%2Fheyi%2FDesktop%2F123.mp4&file_size=7243583&server_type=oupload
 
 

6. 响应示例

{
    "data":[{
      "vid": "XNzMwNzQ3MjIw",
      "upload_token":"MjEyMjk0NTExXzAxMDA2NDNBQTI1M0IwQkYwQ0UxQzIwMDE5NkZGQUY2MDE0OTk4LUVEQjgtNjAwRS03RTExLTg0NTI1REUwMDRDNF8xXzFlNzViMDVlNmZmODg2M2RhNmZhNzYzY2FjYmY4M2Zh",
      "endpoint": "oss-cn-shanghai.aliyuncs.com",
      "security_token": "CAESrAIIARKAAShQquMnLIlbvEcIxO6wCoqJufs8sWwieUxu45hS9AvKNEte8KRUWiJWJ6Y",    
      "oss_bucket": "temp-oss",
      "oss_object": "030002130050D63B4DBF41037C4F6D883566FB-8FB8-B368-37DA-A9733291DC46",
      "temp_access_id": "STS.L4aBSCSJVMuKg5U1vFDw",
      "temp_access_secret": "wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pKCNZ9",
      "expire_time": "2015-04-09T11:52:19Z"
    }],
    "cost":0.00049591064453125,    
}
 

7. 异常示例

8. 注意事项