多条视频详细信息

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 多条视频详细信息
返回格式 Json,UTF8
HTTP请求方式 GET
当前接口版本 V3

2. 系统参数

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

参数名 参数全称 必选 参数类型 参数描述
vid videoid true String 视频ID
ext ext false String 示例:show

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
videoid videoid true String 视频id
title title true String 标题
thumburl thumburl true String 缺省截图url
bigthumbnail bigthumbnail true String 高清截图
showname showname true String 节目名称
showid showid true String 节目id
show_videotype show_videotype true String 节目下的视频类型:正片、预告片、花絮
show_videoseq show_videoseq true String 节目下视频序列号
showdesc showdesc 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 total_vv true String 播放数
tags tags true String 视频标签
seconds seconds true String 播放时长(秒)
publishtime publishtime true String 发布时间(YYYY-MM-DD HH:NN:SS) 查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSSD
sharestate sharestate true String 共享状态:OPEN 开放 FRIEND 仅开放给好友 PASSWORD 有密码 FOLLOWER 仅粉丝 PRIVATE 私有
is_panorama is_panorama true String 是否为全景视频 0-非全景视频 1-全景视频
ischannel ischannel true String 是否为自频道会员视频 0-非自频道会员视频 1-自频道会员视频
desc desc true String 描述
reputation reputation true String 节目评分
total_up total_up true String 视频点赞数
total_comment total_comment true String 评论数
isoriginal isoriginal true String 是否是原创视频:1(是) 0(不是,转载)

5. 调用示例

	
https://openapi.youku.com/router/rest.json?vid=xxxx&ext=show{"format": "json", "timestamp": 1453714831, "access_token": "d9ce66ced641240836cf6011a4c195bc", "sign": "57cd4ab46ce1d8bc9240d99e2120e756", "action": "youku.content.video.info", "client_id": "163d4fd10c7f9a28", "version": "3.0"}

6. 响应示例

   "total": 1,
    "cost": 0.21200001,
    "e": {
        "error_msg": "OK",
        "error_code": 1
    },
    "videos": [
        {
            "thumbnail": "https://r1.ykimg.com/054204085935F0281E596D437B0BB5D5",
            "createtime": "2017-06-05 23:08:43",
            "bigthumbnail": "https://r1.ykimg.com/054104085935F0281E596D437B0BB5D5",
            "link": "http://v.youku.com/v_show/id_XMjgwNjcxMzU3Ng==.html",
            "show": {
                "showname": "楚乔传 TV版",
                "showdesc": "西魏年间乱世混战,大批平民在战乱中沦为奴隶,命如草芥。奴籍少女楚乔被送入人猎场供贵族娱乐射杀,幸得西凉世子燕洵暗中相救。随后她被带进权倾朝野的门阀宇文家,受到开明贵族宇文玥关注,被迫接受严厉训练的同时,更与燕洵结下深厚友谊。西魏门阀争斗,燕洵一家被屠,深陷绝境,楚乔与他生死相守并力助他逃脱困局。",
                "showid": "0f2233c722ec11e6bdbb",
                "show_videotype": "正片",
                "show_videoseq": "2",
                "reputation": "2.00"
            },
            "videoid": "XMjgwNjcxMzU3Ng==",
            "operation_limit": [],
            "title": "楚乔传 02",
            "total_vv": 14630166,
            "total_up": 1463,
            "total_comment": 166,
            "tags": "特工皇妃楚乔传",
            "seconds": "2626.00",
            "isoriginal": 0,
            "sharestate": "OPEN",
            "publishtime": "2017-06-05 23:08:43",
            "download_status": "ALLOWED",
            "state": "normal",
            "category": "电视剧",
            "is_panorama": 0,
            "ischannel": 0,
            "desc": "宇文怀借燕洵生辰宴之际投毒谋杀宇文玥,不料宇文玥早有防备。宇文怀以汁湘的性命做威胁逼迫宇文玥喝下毒酒,小六不忍姐姐无辜受害冒死打翻了酒杯。宇文怀欲杀小六泄愤,幸好燕洵从中斡旋成功帮助小六脱险。祖父宇文灼将谍纸天眼托付给宇文玥,并嘱咐他复兴家族。宇文怀命锦烛在算筹中下毒谋害宇文灼,并将嫌疑推脱到了临惜身上。宇文玥震怒追责,临惜不幸含冤中剑葬身火海。"
        }
    ]
}

		    

7. 异常示例

8. 注意事项