1)
有关专辑和视频查询问题汇总
1> 关于获取演职员信息
建议使用creditList字段获取,虽然credits表示演职员的信息
例如:
credits: "李锐陆毅黄磊曹格吴镇宇杨威多多 Feynman Grace 杨阳洋贝儿"
但这种单独的字段比较复杂,每个频道type有的都不同,名称也不同,电视剧不可能有主持人和嘉宾,综艺也没有主演,导演和编剧,所以推荐直接从演职三级分类获取即根据creditList获取,type用来划分演职员的类型。
2> 有关来源字段
Source字段为空或sourceQipuId字段为“0”,说明此专辑不是按照来源聚合。
反之,此专辑有来源,聚合的时候建议按照sourceqipuId聚合,sourceqipuId是唯一标识。
3> 专辑、视频、来源三者之间的关系
每个视频都有与之相对应的专辑qipuId,比如游戏,音乐等频道都是一个视频归属一个专辑,即专辑与视频是一对一的关系,专辑qipuId与视频qipuId是一对一的。
像电视剧、动漫、纪录片等一个专辑下都有多个视频,即专辑与视频时一对多的关系,比如一档电视剧,这部电视剧下的视频都按照专辑qipuId聚合的,专辑与视频是一对多的。
像综艺等频道会把一档节目归化为一个来源,例如快乐大本营,每一期节目是一个专辑也是一个视频,这些视频都是按照来源qipuId聚合的,一个来源下面多个专辑。
关于来源聚合的时候建议按照sourceqipuId来聚合。
2) 根据更新时间段查询视频接口的使用细节;
1> 如要查询下线数据需加参数status进行查询,status=0说明是失效视频,status=1是有效视频。
2> 开始时间与结束时间跨度是三个小时之内。
3> 如要查询ugc数据需加参数dataType=ugc进行查询,如要ugc+pgc数据需加参数dataType=all进行查询(pgc数据在前,ugc数据在后),默认只查询pgc数据。
4>综艺增量可以根据专辑增量去获取有更新的专辑
在返回的参数中要先得到albumStatus这个参数是用来标示是否下线的
contentType=1 说明此专辑是正片
综艺数据都有sourceQipuId,按照sourceQipuId来聚合的,sourceQipuId是唯一标识
要查询视频的详细信息就再去获取tvQipuId根据视频信息接口去查询。
3) 关于图片尺寸
横图:192 * 108、110 * 70、116 * 65、160 * 90、145 * 90、170 * 100、180 * 101、220 * 124、284 * 160、320 * 180、480 * 270
竖图:57 * 76、75 * 100、95 * 127、120 * 160、180 * 236、195 * 260、260 * 360
如果想要的尺寸为480*270的图片就在后面加上_480_270
例如:

4) 频道id对应的频道
1.电影、2.电视剧、3.纪录片、4.动漫、5.音乐、6.综艺、7.娱乐、8.游戏、
9.旅游、10.片花、12.教育、13.时尚、15.少儿、16.微电影、17.体育、
20.广告、21.生活、22.搞笑、24.财经、25.资讯、26.汽车、27.原创、28.军事
29.母婴、30科技、31.脱口秀、32健康频道
也可以查询频道列表接口,根据apikey查询所有有权限的对应频道信息
5) 关于某一档节目的查询
如果想获取有关“娱乐猛回头”这一档节目的所有视频信息,可以先根据专辑搜索接口查询“娱乐猛回头”的来源奇谱Id(sourceQipuId),比如我要查询的娱乐猛回头是综艺频道下的,
http://expand.video.iqiyi.com/api/search/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&keyWord=娱乐猛回头&categoryIds=6
查找到相应的sourceQipuId

再根据专辑列表接口去查询此档节目(添加参数sourceQipuId=180818701):
http://expand.video.iqiyi.com/api/album/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=6&sourceQipuId=180818701
然后就查到了“娱乐猛回头”这档节目的所有专辑信息,要查询视频的详细信息就再去获取tvQipuId根据视频信息接口去查询。
6) 关于ugc视频查询问题
视频id>180000000且以“09”结尾的都是属于ugc视频,即用户上传视频,使用视频信息接口进行查询,支持根据qipuId查询一周以内的某条视频的详细信息。
详情参照
openApi推送ugc数据。
7) 有关视频地址问题
videoUrl :pc网页端的播放地址
html5PlayUrl:H5端的播放地址
swf:嵌套播放地址(适用于PC网页)
commonSwf:嵌套播放地址(PC和H5通用)
html5Url手机跳转是专辑页面,如下左图,html5PlayUrl手机跳转是视频播放页,如下右图

8) 哪些频道中包含付费内容
电视剧、纪录片、教育、音乐和电影都有付费视频。
9) 那些是爱奇艺独播剧
专辑信息中返回参数:isDubo字段表示是否独播,其中结果为1则表示为爱奇艺独播剧。
10) 查找游戏短视频
例如查找“陈子豪cf解说”专辑,首先利用专辑搜索接口查询,
http://expand.video.iqiyi.com/api/search/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryIds=8&keyWord=陈子豪cf解说
如下图sourceQipuId>0说明是以来源聚合

根据sourceQipuId,利用专辑列表接口获取该来源下的专辑,再用专辑信息接口获取专辑信息,进一步用视频信息接口获取到视频信息。
11) 查询付费内容相关问题
获取专辑列表时若请求不带isCharge参数,apiKey有付费权限,则免费付费都推送,apiKey没有付费权限,则仅推送免费专辑。请求带参数isCharge=1只推送付费专辑,isCharge=0只推送免费专辑。
12) 有关多发数据问题
非多发的专辑:
http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=202139801
下图为非多发的专辑返回参数,ownerAlbumId=-1

多发的专辑(同一个专辑发到不同频道下)
例如:喜羊羊与灰太狼大电影7
该专辑为多发专辑,它的主发频道是少儿频道,多发到电影与动漫
少儿频道的主发专辑:albumQipuId:202525001
电影频道的多发专辑:albumQipuId:200108008
动漫频道的多发专辑:albumQipuId:200107908
查询多发专辑qipuId,ownerAlbumId字段值是其主发专辑的qipuId
http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=200108008

http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=200107908

主发专辑
上图ownerAlbumId参数就是其主发专辑的qipuId
http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=202525001

如上图可以看到主发专辑的ownerAlbumId字段为-1.
这两个专辑与主专辑是一样的专辑,就是分发到不同的频道,但分发专辑信息的ownerAlbumId参数对应的都是主发专辑的id。
13) 有关h5对外播放支持全屏功能
1. H5对外播放页支持全屏功能,需要在 url上添加fullscreen=1参数
0代表全屏状态,1为非全屏状态,不传递参数为屏蔽全屏)
示例如下:
http://dispatcher.video.qiyi.com/common/shareplayer.html?vid=71c300df4a7f4e89a43d8e19e5458e6f&tvId=236086700&coop=&cid=&bd=1&fullscreen=1
备注:tvId的I是大写。
14) 关于综艺拆分脱口秀
爱奇艺站内增加过脱口秀频道,将一部分综艺数据迁移到了脱口秀频道,例如康熙来了、晓松奇谈等。
15)
专辑内容类型
由于各个频道内容类型是统一的,对应的字段是contentType,现各个频道contentType所对应的内容类型展示如下:
1:正片;2:特辑;3:预告片;4:片花;5:花絮;6:宣传片;7:片段;8-25:其他
其中8到25是之前使用过的类型,现已停止使用。可判断contentType >= 8的为其他
16) 播放平台定义
PC_CLIENT_PPS = 1, | IOS_PHONE_IQIYI = 12, |
IPHONE_PPS = 2, | IOS_PAD_IQIYI = 13, |
IPAD_PPS = 3, | PC_QIYI = 14, |
IOS_JAILBREAK_PPS = 4, | H5_QIYI = 15, |
ANDRIOD_PPS = 5, | PAD_WEB_QIYI = 16, |
WINDOWS_PHONE_PPS = 6, | PC_CLIENT_IQIYI = 17, |
MAC_PPS = 7, | ANDROID_PAD_PPS = 18, |
WIN8_PPS = 8, | WINDOWS_PHONE_IQIYI = 19, |
TV_IQIYI = 9, | WINDOWS_PAD_IQIYI = 20, |
ANDROID_PHONE_IQIYI = 10, | WINDOWS_PAD_PPS = 21; |
ANDROID_PAD_IQIYI = 11, | |
17) 接口返回代码说明
A00000=获取数据成功
A00001=注册成功
A00002=更新成功
E00001=参数错误
E00002=未注册
E00003=版权受限
E00004=没有数据
E00005=更新失败
E00006=频道受限
E00007=请输入频道
E00008=此来源数据已失效,请做下线
E00009=无效的apikey,注册失败
E00010=视频增量时间跨度不能超过3小时
E00011=专辑增量时间跨度不能超过2天
18) 播控字段使用说明
playControls字段是控制各个平台是否有播放权限的字段,其判断方法如下:
首先确定
播放平台,例如合作方在pc网页端播放,即播放平台14,platformId=14。
获取到视频信息:
http://expand.video.iqiyi.com/api/video/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=384598500
需要判断视频信息下playControls字段,
platformId=14,avaiableStatus == 1,可以跳转到iqiyi播放,否则14平台无法播放。
platformId=14,avaiableStatus == 1 && cooperationAllowed == 1,可以在站外嵌套播放。
注:若不存在该平台,则该平台视为下线。