根据专辑获取视频

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 根据专辑获取视频
返回格式 Json,UTF8
HTTP请求方式 GET
当前接口版本 V3
历史接口版本 V2

2. 系统参数

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

参数名 参数全称 必选 参数类型 参数描述
id id true String 专辑ID,多个ID请用英文逗号分隔, 最多50个,支持传入编码后专辑ID
part part false String videos(包含视频信息,此时可使用分页排序参数)
vordermode vordermode true string 专辑内视频的排序 desc或者asc(默认),按序号(批量时不支持此参数)
vpn vpn false int 专辑视频列表分页页码,默认为1(批量时不支持此参数)
vpl vpl true int 专辑视频列表分页单页视频数,默认10条,最多50条 (批量时不支持此参数)
caller caller true string 服务调用方

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述

5. 调用示例

https://openapi.youku.com/router/rest.json?caller=OPENAPI&id=2251&opensysparams= {"client_id":"1818a358b8c53851","timestamp":"1474356030","version":"3.0", "sign_method":"md5","sign":"5eeb4a79ff2270860f564bfbde1a6627", "action":"youku.content.video.byalbum.get"}

6. 响应示例

 
{
    data: [
        {
            id: 2251,
            encoded_id: "POTAwNA==",
            snippet: {
                title: "YUI",
                description: "",
                uid: 648849,
                create_time: "2006-11-29 20:46:06",
                update_time: "2015-08-03 10:48:57",
                video_count: 2,
                seconds: 429,
                thumbnails: {
                    default: {
                        url: "http://g4.ykimg.com/1100641F464D168C968D7E04BCBC040B4C02FD-3592-3D5C-C0A1-BE7CE7CDF91E"
                    },
                    medium: {
                        url: "http://g4.ykimg.com/2100641F464D168C968D7E04BCBC040B4C02FD-3592-3D5C-C0A1-BE7CE7CDF91E"
                    },
                    small: {
                        url: "http://g4.ykimg.com/0100641F464D168C968D7E04BCBC040B4C02FD-3592-3D5C-C0A1-BE7CE7CDF91E"
                    }
                },
                category: {
                    id: 127,
                    name: "音乐"
                },
                tags: [
                    "日本女歌手"
                ]
            },
            statistics: {
                view_count: 6392
            },
            types: {
                playlist: 0,
                sys: 0
            }
        }
    ],
    cost: 0.012484073638916
}
			

7. 异常示例

 
{ e: { provider: “folder”, code: -2, desc: “caller invalid” }, cost: 0.000079870223999023 }
    

8. 注意事项

需要申请caller