根据节目获取视频

1. 接口描述

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

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.api.video.byprogram.get
client_id client_id true String 应用的client id
access_token access token false String oauth2的token
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String API协议版本,默认值3.0
sign_method sign_method false String 签名的摘要算法,可选值为:HmacSHA256,md5。默认为md5
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
show_id show_id true String 剧集id,支持批量查询,每个id之间用“,”间隔
show_videotype show_videotype false String 节目中视频类型,默认正片,支持正片,预告片,花絮,普通视频,资讯,MV,首映式,伪正片
show_videostage show_videostage false String 节目中视频的集数或期数(日期型使用YYYYMMDD格式查寻,只有综艺节目按播出日期填写YYYYMMDD格式 其他类型按顺序填写),不建议对外暴露
order_by order_by false String 排序规则,默认:show_videoseq:asc,排序字段只有show_videoseq
page page false int 页码,页码*页长不能大于1200
pageLength pageLength false int 页长,页码*页长不能大于1200

4. 返回参数

>
参数名 参数全称 必选 参数类型 参数描述
videoid videoid true String 视频id
show_videotype show_videotype false String 标题
thumburl thumburl true String 缺省截图url
thumbnail_v2 thumbnail_v2 true String 高清截图
show_videoseq show_videoseq true String 节目下视频序列号
operation_limit operation_limit true array 操作限制COMMENT_DISABLED: 禁评论 DOWNLOAD_DISABLED: 禁下载
download_status download_status true array 下载限制 DISABLED: 禁止下载 VIP_ALLOWED: 仅会员可下载 ALLOWED: 可下载
state state true String 视频状态 normal - 正常
category category true String 视频分类
total_vv_fmt total_vv_fmt true String 播放数提示
total_vv total_vv true String 播放数
seconds seconds true String 播放时长(秒)
publishtime publishtime true String 发布时间(YYYY-MM-DD HH:NN:SS) 查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSSD
is_panorama is_panorama true String 是否为全景视频 0-非全景视频 1-全景视频
total_up total_up true String 视频点赞数
total_comment total_comment true String 评论数

5. 调用示例

	
https://openapi.youku.com/router/rest.json?show_id=8f7472cad7e211e6b9bb&order_by=asc&opensysparams= {"action":"youku.api.video.byprogram.get","client_id":"xxxxxxxx","timestamp":1501830087,"access_token":"", "version":"3.0","sign_method":"md5","sign":"f70d5a6f4cee10f3400014b5ddc438a4"}

6. 响应示例

 {
    "total": 551,
    "cost": 0.062000003,
    "e": {
        "error_msg": "OK",
        "error_code": 1
    },
    "openapi": {
        "traceId": "0badc58415018300994335436e2dc1"
    },
    "videos": [
        {
            "total_up": 18,
            "thumbnail": "https://r1.ykimg.com/05420408593D55271E59723D09074BFF",
            "link": "http://v.youku.com/v_show/id_XMjgxODY4NzM2MA==.html",
            "videoid": "XMjgxODY4NzM2MA==",
            "total_comment": 1,
            "operation_limit": [],
            "title": "哈纳斯野生保育 170611 花儿与少年",
            "total_vv": 28893,
            "seconds": "240.00",
            "show_videostage": "338",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408593D55271E59723D09074BFF",
            "rc_title": null,
            "publishtime": "2017-06-11 22:36:16",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 0,
            "is_panorama": 0,
            "total_vv_fmt": "2.9万"
        },
        {
            "total_up": 3,
            "thumbnail": "https://r1.ykimg.com/05420408593D57071E5895550007E8C2",
            "link": "http://v.youku.com/v_show/id_XMjgxODcwMTc2MA==.html",
            "videoid": "XMjgxODcwMTc2MA==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "花少团迷路迟到 170611 花儿与少年",
            "total_vv": 17016,
            "seconds": "138.00",
            "show_videostage": "341",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408593D57071E5895550007E8C2",
            "rc_title": null,
            "publishtime": "2017-06-11 22:43:54",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 0,
            "is_panorama": 0,
            "total_vv_fmt": "1.7万"
        },
        {
            "total_up": 3,
            "thumbnail": "https://r1.ykimg.com/05420408593D57801E59440C400CD42D",
            "link": "http://v.youku.com/v_show/id_XMjgxODcwNjQ1Ng==.html",
            "videoid": "XMjgxODcwNjQ1Ng==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "花少团动物保育分组 170611 花儿与少年",
            "total_vv": 16548,
            "seconds": "80.00",
            "show_videostage": "342",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408593D57801E59440C400CD42D",
            "rc_title": null,
            "publishtime": "2017-06-11 22:46:00",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 0,
            "is_panorama": 0,
            "total_vv_fmt": "1.7万"
        },
        {
            "total_up": 8,
            "thumbnail": "https://r1.ykimg.com/05420408593D62971E590C68F100F693",
            "link": "http://v.youku.com/v_show/id_XMjgxODc4MzcyMA==.html",
            "videoid": "XMjgxODc4MzcyMA==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "哈纳斯之夜 170611 花儿与少年",
            "total_vv": 19588,
            "seconds": "243.00",
            "show_videostage": "350",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408593D62971E590C68F100F693",
            "rc_title": null,
            "publishtime": "2017-06-11 23:33:36",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 0,
            "is_panorama": 0,
            "total_vv_fmt": "2.0万"
        },
        {
            "total_up": 6,
            "thumbnail": "https://r1.ykimg.com/05420408593D9A851E58E120050CCC73",
            "link": "http://v.youku.com/v_show/id_XMjgxOTAwMzc2NA==.html",
            "videoid": "XMjgxOTAwMzc2NA==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "井柏然合集 170611 花儿与少年",
            "total_vv": 13316,
            "seconds": "285.00",
            "show_videostage": "364",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408593D9A851E58E120050CCC73",
            "rc_title": null,
            "publishtime": "2017-06-12 03:32:30",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 0,
            "is_panorama": 0,
            "total_vv_fmt": "1.3万"
        },
        {
            "total_up": 2,
            "thumbnail": "https://r1.ykimg.com/0542040858F480E8700728062B091B50",
            "link": "http://v.youku.com/v_show/id_XMjcxNDU1OTE3Ng==.html",
            "videoid": "XMjcxNDU1OTE3Ng==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "《花儿与少年3》宣传片",
            "total_vv": 27851,
            "seconds": "39.00",
            "show_videostage": "1",
            "streamtypes": [
                "3gphd",
                "flvhd"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F480E8700728062B091B50",
            "rc_title": null,
            "publishtime": "2017-04-18 10:18:31",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 1,
            "is_panorama": 0,
            "total_vv_fmt": "2.8万"
        },
        {
            "total_up": 16889,
            "thumbnail": "https://r1.ykimg.com/05420408591467991E5986218C059E64",
            "link": "http://v.youku.com/v_show/id_XMjcyNDcwMjgxNg==.html",
            "videoid": "XMjcyNDcwMjgxNg==",
            "total_comment": 5254,
            "operation_limit": [],
            "title": "花儿与少年 170423",
            "total_vv": 107736705,
            "seconds": "4591.00",
            "show_videostage": "20170423",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408591467991E5986218C059E64",
            "rc_title": "井柏然陈柏霖争当导游",
            "publishtime": "2017-04-23 22:08:29",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 1,
            "is_panorama": 0,
            "total_vv_fmt": "1.1亿"
        },
        {
            "total_up": 4,
            "thumbnail": "https://r1.ykimg.com/0542040858F59F026C1E1A3A4C444ACB",
            "link": "http://v.youku.com/v_show/id_XMjcxNDc5OTM1Mg==.html",
            "videoid": "XMjcxNDc5OTM1Mg==",
            "total_comment": 3,
            "operation_limit": [],
            "title": "[未播]倒计时之宋祖儿篇",
            "total_vv": 84819,
            "seconds": "16.00",
            "show_videostage": "2",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F59F026C1E1A3A4C444ACB",
            "rc_title": null,
            "publishtime": "2017-04-18 13:02:20",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "娱乐",
            "show_videoseq": 2,
            "is_panorama": 0,
            "total_vv_fmt": "8.5万"
        },
        {
            "total_up": 11171,
            "thumbnail": "https://r1.ykimg.com/0542040859144FB21E594A36D10589E7",
            "link": "http://v.youku.com/v_show/id_XMjczNzcwNDEwNA==.html",
            "videoid": "XMjczNzcwNDEwNA==",
            "total_comment": 3933,
            "operation_limit": [],
            "title": "花儿与少年 170430",
            "total_vv": 105065987,
            "seconds": "4749.00",
            "show_videostage": "20170430",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040859144FB21E594A36D10589E7",
            "rc_title": "娜扎张若昀上演尬舞秀",
            "publishtime": "2017-04-30 20:35:53",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 2,
            "is_panorama": 0,
            "total_vv_fmt": "1.1亿"
        },
        {
            "total_up": 4,
            "thumbnail": "https://r1.ykimg.com/0542040858F5909E6C1E2D4227F43EE3",
            "link": "http://v.youku.com/v_show/id_XMjcxNDcxNDk5Ng==.html",
            "videoid": "XMjcxNDcxNDk5Ng==",
            "total_comment": 2,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之华晨宇",
            "total_vv": 14457,
            "seconds": "118.00",
            "show_videostage": "3",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "mp5hd",
                "mp5hd2"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F5909E6C1E2D4227F43EE3",
            "rc_title": null,
            "publishtime": "2017-04-18 12:10:07",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 3,
            "is_panorama": 0,
            "total_vv_fmt": "1.4万"
        },
        {
            "total_up": 8420,
            "thumbnail": "https://r1.ykimg.com/054204085923B2DD1E596D7B83067A4E",
            "link": "http://v.youku.com/v_show/id_XMjc1MDQwMDMyMA==.html",
            "videoid": "XMjc1MDQwMDMyMA==",
            "total_comment": 2147,
            "operation_limit": [],
            "title": "花儿与少年 170507",
            "total_vv": 73433582,
            "seconds": "4614.00",
            "show_videostage": "20170507",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/054104085923B2DD1E596D7B83067A4E",
            "rc_title": "花少团爆笑学跳桑巴舞",
            "publishtime": "2017-05-07 19:37:11",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 3,
            "is_panorama": 0,
            "total_vv_fmt": "7343.4万"
        },
        {
            "total_up": 4,
            "thumbnail": "https://r1.ykimg.com/0542040858F5CA546C1E2241B7BB551E",
            "link": "http://v.youku.com/v_show/id_XMjcxNDY5NjIxNg==.html",
            "videoid": "XMjcxNDY5NjIxNg==",
            "total_comment": 2,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之杨祐宁",
            "total_vv": 25444,
            "seconds": "29.00",
            "show_videostage": "4",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F5CA546C1E2241B7BB551E",
            "rc_title": null,
            "publishtime": "2017-04-18 11:49:16",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 4,
            "is_panorama": 0,
            "total_vv_fmt": "2.5万"
        },
        {
            "total_up": 8201,
            "thumbnail": "https://r1.ykimg.com/05420408591E02271E598A0671087606",
            "link": "http://v.youku.com/v_show/id_XMjc2NDYxMzM5Ng==.html",
            "videoid": "XMjc2NDYxMzM5Ng==",
            "total_comment": 1907,
            "operation_limit": [],
            "title": "花儿与少年 170514",
            "total_vv": 65232217,
            "seconds": "5047.00",
            "show_videostage": "20170514",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408591E02271E598A0671087606",
            "rc_title": "花少团探访亚马逊雨林",
            "publishtime": "2017-05-14 22:07:18",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 4,
            "is_panorama": 0,
            "total_vv_fmt": "6523.2万"
        },
        {
            "total_up": 9,
            "thumbnail": "https://r1.ykimg.com/0542040858F5CA656C1E1C2590E1BCBC",
            "link": "http://v.youku.com/v_show/id_XMjcxNDY5NDQ0OA==.html",
            "videoid": "XMjcxNDY5NDQ0OA==",
            "total_comment": 2,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之古力娜扎",
            "total_vv": 29558,
            "seconds": "29.00",
            "show_videostage": "5",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F5CA656C1E1C2590E1BCBC",
            "rc_title": null,
            "publishtime": "2017-04-18 11:49:19",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 5,
            "is_panorama": 0,
            "total_vv_fmt": "3.0万"
        },
        {
            "total_up": 5913,
            "thumbnail": "https://r1.ykimg.com/054204085922094F1E590F22B20924B4",
            "link": "http://v.youku.com/v_show/id_XMjc3NzkwNzUxMg==.html",
            "videoid": "XMjc3NzkwNzUxMg==",
            "total_comment": 3073,
            "operation_limit": [],
            "title": "花儿与少年 170521",
            "total_vv": 67404429,
            "seconds": "4565.00",
            "show_videostage": "20170521",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/054104085922094F1E590F22B20924B4",
            "rc_title": "张若昀接替井宝变导游",
            "publishtime": "2017-05-21 22:51:48",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 5,
            "is_panorama": 0,
            "total_vv_fmt": "6740.4万"
        },
        {
            "total_up": 1,
            "thumbnail": "https://r1.ykimg.com/0542040858F58E946C1E0D548599CA25",
            "link": "http://v.youku.com/v_show/id_XMjcxNDY5MjA4NA==.html",
            "videoid": "XMjcxNDY5MjA4NA==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之井柏然",
            "total_vv": 21148,
            "seconds": "30.00",
            "show_videostage": "6",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F58E946C1E0D548599CA25",
            "rc_title": null,
            "publishtime": "2017-04-18 11:52:36",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 6,
            "is_panorama": 0,
            "total_vv_fmt": "2.1万"
        },
        {
            "total_up": 4964,
            "thumbnail": "https://r1.ykimg.com/05420408592B5ED01E59063919043D71",
            "link": "http://v.youku.com/v_show/id_XMjc5MTAzODI4NA==.html",
            "videoid": "XMjc5MTAzODI4NA==",
            "total_comment": 2376,
            "operation_limit": [],
            "title": "花儿与少年 170528",
            "total_vv": 76368594,
            "seconds": "4645.00",
            "show_videostage": "20170528",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/05410408592B5ED01E59063919043D71",
            "rc_title": "张若昀当导游状况百出",
            "publishtime": "2017-05-28 21:52:42",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 6,
            "is_panorama": 0,
            "total_vv_fmt": "7636.9万"
        },
        {
            "total_up": 7,
            "thumbnail": "https://r1.ykimg.com/0542040858F5CA4E6C1E177563926A21",
            "link": "http://v.youku.com/v_show/id_XMjcxNDY4OTYxNg==.html",
            "videoid": "XMjcxNDY4OTYxNg==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之宋祖儿",
            "total_vv": 26553,
            "seconds": "29.00",
            "show_videostage": "7",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F5CA4E6C1E177563926A21",
            "rc_title": null,
            "publishtime": "2017-04-18 11:51:03",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 7,
            "is_panorama": 0,
            "total_vv_fmt": "2.7万"
        },
        {
            "total_up": 5443,
            "thumbnail": "https://r1.ykimg.com/054204085935A3451E590B187E0CB28F",
            "link": "http://v.youku.com/v_show/id_XMjgwNDU5MzY0NA==.html",
            "videoid": "XMjgwNDU5MzY0NA==",
            "total_comment": 2792,
            "operation_limit": [],
            "title": "花儿与少年 170604",
            "total_vv": 70635087,
            "seconds": "4783.00",
            "show_videostage": "20170604",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/054104085935A3451E590B187E0CB28F",
            "rc_title": "花少团救助转移长颈鹿",
            "publishtime": "2017-06-04 22:53:01",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "综艺",
            "show_videoseq": 7,
            "is_panorama": 0,
            "total_vv_fmt": "7063.5万"
        },
        {
            "total_up": 5,
            "thumbnail": "https://r1.ykimg.com/0542040858F5A8B56C1E282731CD2FB4",
            "link": "http://v.youku.com/v_show/id_XMjcxNDY4OTA3Mg==.html",
            "videoid": "XMjcxNDY4OTA3Mg==",
            "total_comment": 0,
            "operation_limit": [],
            "title": "《花儿与少年3》个人宣传片之陈柏霖",
            "total_vv": 25134,
            "seconds": "29.00",
            "show_videostage": "8",
            "streamtypes": [
                "3gphd",
                "flvhd",
                "hd",
                "hd2",
                "hd3",
                "mp5hd",
                "mp5hd2",
                "mp5hd3"
            ],
            "thumbnail_v2": "https://r1.ykimg.com/0541040858F5A8B56C1E282731CD2FB4",
            "rc_title": null,
            "publishtime": "2017-04-18 11:56:11",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "广告",
            "show_videoseq": 8,
            "is_panorama": 0,
            "total_vv_fmt": "2.5万"
        }
    ]
}
		

7. 异常示例

8. 注意事项