创建上传任务

1. 接口描述

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

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 上传文件服务类型 nupload表示基于Http协议实现的视频文件上传服务, gupload表示超G上传服务
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,每个上传任务的唯一标识
upload_server string true 上传服务器URI,只有当instant_upload_ok值为’no’时返回,用户应当将这里的URI解析为IP地址,以备后续接口中替换相应域名

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
 

6. 响应示例

cost: 0.093,
data: [
{
vid: "XMjcyOTYwMzUyOA==",
upload_token: "MjUwODA5NDc5XzAxMDA2NDNBQTI1OTAwMjAxNEJCQUQxOEQ5NDA2QzlENjk1NzlDLTU0ODktMEQ2OS0y
MjRGLUNFODc5RTQ1QzE2NV8xX2ZiMTc0ZDQwNTU5NWJhNzA5NGNkNzkxY2UzZDkxOTBi",
upload_server: "g1.up.youku.com"
}
],
e: {
error_msg: "OK",
error_code: 1
}
}
 

7. 异常示例

8. 注意事项