视频上传任务创建

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 将视频上传至云点播(返回视频上传地址URL,供写入视频数据)
返回格式 json,UTF8
HTTP请求方式 GET
是否需要登录
当前接口版本 V3

2. 系统参数

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

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
title title true String 视频标题
tags tags false String 视频标签
desc desc false String 视频描述
ip ip false String 创建IP
category_id category_id false long 视频所属分类sid
user_id user_id false String 用户id
attr_values attr_values false jsonarray 属性值
md5 md5 false String 视频文件md5
file_size file_size true long 视频文件大小
file_format file_format false String 视频文件格式

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
error error true object 错误码
cost cost true float 接口执行时间
fid fid true String 文件id
upload_url upload_url true String 上传服务器地址,供写入视频数据,上传视频数据至此地址的同时,需要带上fid和token, 并转义成id和sign
token token true String token值,安全验证相关
file_uploade file_uploade true boolean 文件是否已经上传过
vid vid true String 视频id

5. 调用示例

https://openapi.youku.com/router/rest.json?file_formate=mov&tags=示例
&file_size=41925771&md5=&opensysparams={"timestamp": 1468303799, "client_id":
 "163d4fd10c7f9a28", "action": "youku.api.vod.upload.video", "sign":
"e46aef7e58eb2479678c4a4b849563bc", "version": 
"3.0", "access_token": "d9ce66ced641240836cf6011a4c195bc"}&title=ios云点播上传sdk
  			

6. 响应示例

{
    "e": {
        "desc": "",
        "provider": "cloudvideo",
        "code": 0
    },
    "data": {
        "fid": "579ef1b10cf2fdfa002d9f96",
        "token": "1470034353690QNej",
        "upload_url": "http://uvod.open.youku.com/cloudvideo/uploader/post.json",
        "vid": "579ef1b10cf2fdfa002d9f97",
        "file_uploaded": false
    },
    "cost": 0.0310000013560056
			

7. 异常示例

8. 注意事项