帮助文档
提交上传任务
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. 注意事项
无
400-810-3568 转 4
303221837