保存上传信息

1. 接口描述

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

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.video.upload.save
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 上传token
title string false 视频标题,最多80个字(不区分汉字及字符)
description string false 视频简介,最多2000个字(不区分汉字及字符)
original string false original: 原创 reproduced: 转载
privacy string false 视频隐私状态,password表示加密,friend表示紧好友观看,anybody表示完全公开,follower仅粉丝观看,private私有视频
password string false 视频观看密码,当privacy 设置为password,该参数为必填项
category_name string false 视频一级分类名称
subcategory_ids string false 视频一级分类对应的二级分类,多个用逗号分隔
description string false 视频简介,最多2000个字(不区分汉字及字符)
tags string false 视频标签,多个用逗号分隔。 合法的标签由1-20个字组成,一个视频最多允许设置10个标签
recording_location string false 视频拍摄地区, 例如(中国区 北京市 朝阳区)
recording_address string false 视频拍摄街道地址,例如(中国区 北京市 朝阳区芳草地街道8号)
recording_longitude double false 视频拍摄地理经度
recording_latitude double false 视频拍摄地理纬度
recording_date datetime false 视频拍摄时间
cover_timestamp float false 视频封面截图时间点
deshake int false 1表示需要防抖处理,0表示不需要。 默认为0
share int false 1表示视频参与分成,0表示不参与。 默认为0
sync_tudou int false 1表示同步到土豆,0表示不同步。 默认为0
download_disabled int false 1表示禁下载,0表示不禁下载。默认为0
auto_block int false 1表示自动屏蔽,0表示不屏蔽。默认为0
bullet string false 1表示弹幕视频, 0表示非弹幕视频。默认为0
panorama int false 1表示全景视频, 0表示非全景视频
publish_time datetime false 定时发布时间,格式为“年-月-日 时:分:秒”(例子:2015-10-29 22:21:20)
album_id string false 视频夹id
declare_copyright int false 0表示未声明,1表示声明原创,2表示声明授权
auto_block int false 1表示自动屏蔽,0表示不屏蔽。默认为0
topic_info string false 话题内容,多个用逗号分隔
thumbnail_custom int false 自定义截图ID

4. 返回参数

参数名 参数类型 允许为空 参数描述
error object true 出错时返回
code int false 错误码
upload_token String false 上传token
vid string false 视频ID

5. 调用示例

https://openapi.youku.com/router/rest.json?category_name=电视剧&ip=42.120.74.111&opensysparams={"client_id":"84292d14de7ac6c6","timestamp":"1493188639","version":"3.0",
"sign_method":"md5","sign":"d6ce289688b91f8d9bb7330138d63c4d","action":"youku.video.upload.save","access_token":
"a35c5e97ab67efcf225b23a2f610228f"}&original=original&panorama=0&privacy=anybody&tags=原创&upload_token=MjQ5MzExOTMxXzAxMDA2NDNBQTI1OEY5QzhDNTlDNjcwMDU1NEQ1Q0M0QkZGMjE0LUIzNUYtNTBEMy0zQT
Y5LTE0OTEzQTdGMDUyOV8xX2MwMjNiZDAzZGExNmFmMTVmNmY4ZDQyMzczZTYyMjlj
    

6. 响应示例


{
    "data":[{
      "vid": "XNzMwNzQ3MjIw",
      "upload_token":"MjEyMjk0NTExXzAxMDA2NDNBQTI1M0IwQkYwQ0UxQzIwMDE5NkZGQUY2MDE0OTk4LUVEQjgtNjAwRS03RTExLTg0NTI
	  1REUwMDRDNF8xXzFlNzViMDVlNmZmODg2M2RhNmZhNzYzY2FjYmY4M2Zh"
    }],
    "cost":0.00049591064453125,    
}




		

7. 异常示例

8. 注意事项