视频收藏

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 视频收藏
返回格式 Json,UTF8
HTTP请求方式 GET
授权/登录 true
当前接口版本 V3
历史接口版本 V2

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.user.interaction.video.favorite
client_id client_id true String 应用的client id
access_token access token false String oauth2的token
format format false String 可选,指定响应格式。默认保持代理接口格式化,目前支持格式为xml,json,text
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String 3.0
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
token true string 注册(非注册)用户token
type true string 收藏类型
id true long 被收藏内容的原始记录id(比如:视频id、剧集id)
fid folder id false int 视频所属的专辑id(收藏视频时生效)
vid video id false int 专辑的第一个视频id(收藏专辑时生效)
create_time true int 添加收藏时间
vid video id false int 专辑的第一个视频id(收藏专辑时生效)
mt media type false string 媒体类型(yk/tv)
ext extension false string 扩展信息
注:收藏type是视频时,id传入视频id,如果该视频属于某个专辑,fid传入该专辑id,vid被忽略;
收藏type是剧集时,id传入剧集id,fid、vid被忽略;
收藏type是专辑时,id传入专辑id,fid被忽略,vid传入该专辑的第一个视频id;
收藏type是标签时,id传入标签id,fid、vid被忽略。
    

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
error object 错误码
cost float 接口执行时间

5. 调用示例

http://api.youku.com/favorite/favorite/add.json?token=a43939a187643976439a187643939a18&type=show&id=254778&create_time=22123320
  			

6. 响应示例

{
  	"e":{"code":0,"provider":"favorite","desc":""},
	"cost":0.0046088695526123
}
			

7. 异常示例

8. 注意事项

用户添加收藏,目前支持收藏视频/专辑/剧集/标签。

收藏type是视频时,id传入视频id,如果该视频属于某个专辑,fid传入该专辑id,vid被忽略;
收藏type是剧集时,id传入剧集id,fid、vid被忽略;
收藏type是专辑时,id传入专辑id,fid被忽略,vid传入该专辑的第一个视频id;
收藏type是标签时,id传入标签id,fid、vid被忽略。