提交上传任务

1. 接口描述

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

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.video.upload.complete
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. 业务参数

参数名 参数类型 必选 默认值 参数描述
upload_token string true create过程返回值
upload_server_ip string true 上传服务器IP

4. 返回参数

视频源文件上传状态

参数名 参数类型 允许为空 参数描述
error object true 出错时返回
code int false 错误码
type String false 错误类型
description int false 错误描述
status int true

1:文件上传完成,并且全部确认写入磁盘

2:文件上传中,全部分片上传任务已经分派,见返回字段transferred_percent

3:文件上传中,所有分片上传任务都已完成,但是依然有的分片还未确认写入磁盘,见返回字段confirmed_percent

4:文件上传中,还有分片上传任务未分配

transferred_percent int false 服务器接收数据百分比,当status=2时有意义
confirmed_percent int false 服务器接收数据并确认写入磁盘百分比,当status=3时有意义
empty_tasks int64 false 未分配的任务,当status=4时有意义
finished/td> boolen false 文件是否全部上传
upload_server_ip string false 上传服务器地址

5. 调用示例

        https://openapi.youku.com/router/rest.json?ip=42.120.74.111&opensysparams={"client_id":"84292d14de7ac6c6","timestamp":"1493189832","version":"3.0","sign_method":"md5","sign":"51784451f662e6c2d1f87a23c2143f88","action":"youku.video.upload.complete","access_token":"a35c5e97ab67efcf225b23a2f610228f"}&upload_server_ip=g1.up.youku.com&upload_token=MjQ5MzExOTMxXzAxMDA2NDNBQTI1OEY5QzhDNTlDNjcwMDU1NEQ1Q0M0QkZGMjE0LUIzNUYtNTBEMy0zQTY5LTE0OTEzQTdGMDUyOV8xX2MwMjNiZDAzZGExNmFmMTVmNmY4ZDQyMzczZTYyMjlj
		

6. 响应示例

{
    "data":[{
      "vid": "XNzMwNzQ3MjIw",
      "upload_token":"MjEyMjk0NTExXzAxMDA2NDNBQTI1M0IwQkYwQ0UxQzIwMDE5NkZGQUY2MDE0OTk4LUVEQjgtNjAwRS03RTExLTg0NTI1REUwMDRDNF8xXzFlNzViMDVlNmZmODg2M2RhNmZhNzYzY2FjYmY4M2Zh"
    }],
    "cost":0.00049591064453125,    
}


		

7. 异常示例

8. 注意事项