一、接口说明

     备注:ApiServer = expand.video.iqiyi.com
          其中apiKey 值为测试key: 71c300df4a7f4e89a43d8e19e5458e6f(此为测试key ,合作方正式上线请不要使用此apikey。)

1.专辑信息接口

接口说明:
      根据专辑ID查询专辑详细信息。
请求形式:
      http:///api/album/info.json?apiKey=&qipuId=
      http:///api/album/info.xml?apiKey=&qipuId=
例如: http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=235820900
参数说明:
参数名说明数据类型 是否必须取值
apiKeyapiKey字符串
albumId专辑ID数字(与qipuId二选一) 废弃(qipuId替代)
qipuId专辑的奇谱ID数字(与albumId二选一)
coopal是否站外合作数字 1:允许,0:禁止 不传默认都推送
返回结果:
节点说明备注
albumId专辑ID废弃(qipuId替代)
qipuId专辑的奇谱ID
albumName专辑名称
keyword隶属影视剧
categoryId频道ID
sets总集数0:该专辑的总集数不确定,剧集还在增加
purchaseType是否付费0:会员免费;1:会员包月付费;2:会员点播付费
isPurchase是否需要付费观看0:否;1:付费
payMark付费角标0:无角标 1:vip角标2:付费点播角标3:点播券角标
playcnt播放次数
albumStatus专辑状态0:无效,1:有效
tvYear发行年份
copyrightId版权id
companyName版权方名称
startDate版权开始时间
endDate版权结束时间
focus专辑看点
producer制片人
tvIds专辑下的视频ID废弃(tvQipuIds替代)
tvQipuIds专辑下视频的奇谱ID
score评分
down踩数
up顶数
voters投票数
credits专辑演职员信息
leafctgs标签
albumUrl专辑页地址
picUrl专辑图
posterPicUrl海报图
desc描述
source综艺频道的来源
contentType专辑的内容类型各频道不太相同详情参看常见问题汇总20) 专辑内容类型
threeCtgs 三级分类 
Id三级分类ID
Name三级分类名称
subtype二级级分类ID
subCtgName二级分类名称
creditList演职员信息 
name 姓名
roleName 角色名
type 类型(取值:0:主持人;1:灯光;2:配音;3:评论员;4:演讲者;5:受访嘉宾;6:嘉宾;7:讲师;8:主演;9:舞蹈演员;10:歌手;11:演员
isSD是否超清1:是;0:否
html5UrlHtml5专辑页 
Html5PlayUrl Html5播放页 
sourceId来源ID废弃(sourceQipuId代替)
sourceQipuId来源的奇谱ID 
subTitle专辑别名 
actor主演/主持人 
director 作者 
area地区 
albumType专辑类型  
playUrl第一集播放链接 
createdTime专辑创建时间 
timeLength 第一集播放时长 
ownerAlbumId 多发对应的主发专辑qipuId-1:没有多发
IsDubo 是否是爱奇艺独播剧1:是;0:不是
is3D 是否为3d视频1:是; 0:不是
IsCoopAllowed 是否允许站外合作1:是; 0:不是
alias 别名
season
edition 版本
subsites地方站信息 
id 地方站ID,数字
name 地方站名称,字符串
level 地方站等级,数字1 常规; 2中级; 3 高级;
备注:关于“来源类”专辑视频调取流程说明
      关于专辑、视频、来源三者之间的关系,常见问题1中有详细的介绍。
      站内数据包括两种聚合方式,一种是来源的形式聚合(比如快乐大本营,综艺频道都是以来源聚合,其他频道也有部分是来源聚合,具体需要根据sourceQipuId来判断),另一种是专辑形式的聚合(比如电视剧花千骨)。
      获取数据的方式如下:这里使用测试apikey为例:71c300df4a7f4e89a43d8e19e5458e6f
①首先,从频道列表接口根据apikey 查询此key开通的频道列表
http://expand.video.iqiyi.com/api/category/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f

如上图:此apikey开通了1、2、4、6、15、31频道
②从专辑列表接口按照频道取专辑列表数据
http://expand.video.iqiyi.com/api/album/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=2


如以上两张图,取到的数据中若sourceQipuId字段为空或sourceQipuId字段为“0”,说明此专辑不是按照来源聚合(是按照专辑聚合)。反之,此专辑为来源,聚合的时候建议按照sourceQipuId聚合,sourceQipuId是来源的唯一标识。
③若是按照专辑聚合的数据(如下图,sourceQipuId为0),则根据开通的频道列表,通过专辑列表接口,获取到专辑列表,然后直接到第④步。 http://expand.video.iqiyi.com/api/album/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=2

若是以来源聚合的数据,则根据开通的频道列表,通过来源列表接口,获取到来源列表 http://expand.video.iqiyi.com/api/s/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&&categoryId=2
来源列表中的每个来源都有qipuId字段(来源的唯一ID,如上图),再根据专辑列表接口加上sourceQipuId参数,查出该来源下的专辑列表,如下接口地址和下图所示 http://expand.video.iqiyi.com/api/album/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=2&sourceQipuId=111367401
④再根据专辑列表中的qipuId(专辑的唯一ID),从专辑信息接口,查询到专辑的详细信息 http://expand.video.iqiyi.com/api/album/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=523856600
专辑详细信息中有tvQipuIds字段(如上图),是该专辑下包含视频的奇谱Id(视频的唯一ID)。
⑤最后根据视频的qipuId,从视频信息接口中,查出该视频的详细信息
http://expand.video.iqiyi.com/api/video/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=523856600

增量数据则通过根据更新时间段查询专辑列表接口根据更新时间段查询视频接口按照时间段获取某一频道下数据
http://expand.video.iqiyi.com/api/album/udlist.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&startTime=20150714120000&endTime=20150715150000&categoryId=2&status=1
同样根据sourceQipuId判断是否以来源聚合,之后再接着取专辑、视频。步骤同③。

2.视频信息接口

接口说明:
      根据视频ID查询视频详细信息。
请求形式:
      http:///api/video/info.json?apiKey=&qipuId=
      http:///api/video/info.xml?apiKey=&qipuId=
例如: http://expand.video.iqiyi.com/api/video/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=289093200
参数说明:
参数名说明数据类型 是否必须取值
apiKeyapiKey字符串
tvId视频(剧集)ID数字 是(与qipuId二选一)废弃
qipuId视频(剧集)的奇谱ID数字 是(与tvId二选一)
返回结果:
节点 说明 备注
tvId 视频ID 废弃(qipuId代替)
qipuId 视频的奇谱ID  
tvName 视频名称
videoStatus 视频状态 0:无效,1:有效
beginTime 视频开始时间  
endTime 视频结束时间  
timeLength 视频播放时长  
albumId 专辑ID 废弃(albumQipuId代替)
albumQipuId 专辑对应的奇谱Id  
playOrder 视频播放顺序  
tvYear 发行年份  
keyWord 视频关键词  
subTitle 视频副标题  
domainName 视频所属最终页发布的域名  
updateTime 视频最后一次更新时间  
issueTime 视频首次发布时间  
tvUniqId 视频vid  
videoImage 视频图片地址  
videoUrl 视频url
desc 描述  
Html5PlayUrl Html5播放页地址  
categoryId 频道ID  
Swf 分享播放器地址  
androidApp 安卓app调起字段 根据合作方生成对应的调起地址
iosApp 苹果app调起字段 根据合作方生成对应的调起地址
contentType 视频的内容类型 各频道不太相同详情参看常见问题汇总20. 专辑的内容类型
commonSwf 通用swf
is3D 是否为3d视频 1:是; 0:不是
isPurchase 是否需要付费观看 0:免费; 1、2:付费
payMark 付费角标 0:无角标 1:vip角标 2:付费点播角标 3:点播券角标
memberDownloadableOnly 是否仅会员可下载 1:是 0:否 注:该字段需在可下载(播控平台可下载)的前提下才有效(即需要先判断播控中某个平台下可下载,再判断该字段才有意义)
is1080p 是否支持1080p 1:支持; 0:不支持
isDolby 是否支持杜比 1:支持; 0:不支持
panorama 全景字段全景视频的属性
videoType视频类型1:普通视频 2:360度全景视频 3:180度全景视频4:广角视频
viewAngleX视角X坐标
viewAngleY视角Y坐标
zoomRate放大倍数
renderingType渲染类型:(普通视频无此字段)0:球面渲染 1:棱锥渲染
playControls 播放控制控制各个平台权限
platformId播放平台Id,详见常见问题汇总21)播放平台定义
downloadAllowed该平台是否允许下载1:允许,0:不允许
cooperationAllowed该平台是否允许站外合作1:允许,0:不允许
availableStatus在线状态1:在线2:版权原因下线3:其他原因下线
subsites 地方站信息
id地方站ID, 数字
name地方站名称, 字符串
level地方站等级,数字 1 常规; 2中级; 3 高级;

3.专辑列表接口

接口说明:
      根据频道ID分页查询该频道下的专辑列表。
请求形式:
      http:///api/album/list.json?apiKey=&categoryId=&keyWord=&pageNo=&pageSize=&categoryId=
      http:///api/album/list.xml?apiKey=&categoryId=&keyWord=&pageNo=&pageSize=&categoryId=
例如: http://expand.video.iqiyi.com/api/album/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=28&sourceQipuId=

参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
categoryId 频道ID 数字  
scode 来源CODE 数字 废弃(sourceQipuId代替)
sourceQipuId 来源的奇谱ID 数字  
pageNo 起始页码 数字 默认1
pageSize 页容量 数字 默认、最大100
coopal 是否站外合作 数字 1:允许,0:禁止 不传默认都推送
isCharge 是否付费 数字 1:付费,0:免费 默认:有vip权限都推,没有vip权限推免费
注:keyWord需要URLEncoder处理

返回结果:参照专辑信息数据

4.频道列表接口

接口说明:
      查询apiKey开通权限的频道列表。
请求形式:
      http:///api/category/list.json?apiKey=
      http:///api/category/list.xml?apiKey=
例如: http://expand.video.iqiyi.com/api/category/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f

参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  

返回结果:
节点 说明 备注
categoryId 频道ID 频道ID为0仅表示该apiKey有vip权限(能获取付费内容),0不是有效的频道
categoryName 频道名称  
shortName 频道短名称  

5.根据更新时间段查询视频接口

接口说明:
      查询某个时间段内更新的视频。
请求形式:
      http:///api/video/list.json?apiKey=&startTime=&endTime=&pageNo=&pageSize=& categoryId =
      http:///api/video/list.xml?apiKey=&startTime=&endTime=&pageNo=&pageSize=& categoryId =
例如: http://expand.video.iqiyi.com/api/video/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=1&startTime=yyyyMMddhhmmss&endTime=yyyyMMddhhmmss&dataType=
参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
startTime 开始时间 字符串 格式:yyyyMMddHHmmss
endTime 结束时间 字符串 格式:yyyyMMddHHmmss
categoryId 频道ID 数字
pageNo 起始页码 数字 默认1
pageSize 页容量 数字 默认、最大100
status 视频状态 数字 0:无效, 1:有效默认都推
dataType 数据类型 字符串 默认:查询pgc数据; all:查询ugc+pgc数据,pgc数据在前,ugc数据在后; ugc:查询ugc更新数据。
isCharge 是否付费 数字 1:付费,0:免费 默认:有vip权限都推,没有vip权限推免费
timeLength 播放时长 数字 单位:秒,只出低于给定秒数的视频信息

返回结果:参照视频信息数据

6.根据更新时间段查询专辑列表接口

接口说明:
      查询某个时间段内更新的专辑。
请求形式:
      http:///api/album/udlist.json?apiKey=&startTime=&endTime=&pageNo=&pageSize=& categoryId= &status=
      http:///api/album/udlist.xml?apiKey=&startTime=&endTime=&pageNo=&pageSize=& categoryId=&status=
例如: http://expand.video.iqiyi.com/api/album/udlist.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&startTime=yyyyMMddhhmmss&endTime=yyyyMMddhhmmss&categoryId=1&status=1
参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
startTime 开始时间 字符串 格式:yyyyMMddHHmmss
endTime 结束时间 字符串 格式:yyyyMMddHHmmss
status 专辑状态 数字 0:无效、1:有效默认都推
pageNo 起始页码 数字 默认1
pageSize 页容量 数字 默认、最大100
categoryId 频道ID 数字  
coopal 是否站外合作 数字 1:允许,0:禁止 不传默认都推送
isCharge 是否付费 数字 1:付费,0:免费 默认:有vip权限都推,没有vip权限推免费

7.排行榜数据接口

接口说明:
      查询评分、日、周、月、总播放次数排行榜。
请求形式:
      http:///api/top/list.json?apiKey=&topType=&categoryId=
      http:///api/top/list.xml?apiKey=&topType=&categoryId=
例如: http://expand.video.iqiyi.com/api/top/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&topType=1&categoryId=1
参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
topType 排行榜类型 数字 评分:0,日:1,周:2,月:3,总:4
categoryId 频道ID 数字  
limit 页容量 数字 评分榜目前只支持50条数据其他排行榜类型最大支持150条数据

返回结果:参照专辑信息数据

8.来源列表接口

接口说明:
      根据频道ID分页查询该频道下来源列表。
请求形式:
      http:///api/s/list.json?apiKey=&categoryId=
      http:///api/s/list.xml?apiKey=&categoryId=
例如: http://expand.video.iqiyi.com/api/s/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&categoryId=6
参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
categoryId 频道ID 数字  
sourceQipuId 来源的奇谱ID 数字  
pageNo 起始页码 数字 默认1
pageSize 页容量 数字 默认、最大100
注:keyWord需要URLEncoder处理

返回结果:
节点 说明 备注
qipuId 来源的qipuId  
scode 来源代码 废弃(qipuId代替)
sname 来源名称  
company 播出方  
emcee 主持人  
picUrl 图片地址  
desc 描述  
playTime 播出时间  
isDubo 是否是爱奇艺独播 1:是; 0:不是
categoryId 频道Id  
areas 地区  
type 类型  
season  
edition 版本  
payMark 付费角标 0:无角标 1:vip角标 2:付费点播角标 3:点播券角标
subsites 地方站信息  
id 地方站ID, 数字
name 地方站名称, 字符串
level 地方站等级,数字 1 常规; 2中级; 3 高级;
注: 请求参数中指定scode为查询单个来源。

9.专辑搜索接口

接口说明:
      根据关键字、专辑分类搜索专辑信息。
请求形式:
      http:///api/search/list.json?apiKey=&keyWorld=
      http:///api/search/list.xml?apiKey=&keyWorld=
例如: http://expand.video.iqiyi.com/api/search/list.json?type=list&apiKey=71c300df4a7f4e89a43d8e19e5458e6f&keyWord=木奇灵
参数说明:
参数名 说明 数据类型 必须 取值
apiKey apiKey 字符串  
keyWord 专辑名称关键词 字符串  
categoryIds 频道ID串 字符串 多个以“,”分割,为或的关系
threeCategory 三级分类名称 字符串 多个以“,”分割, 为或的关系
pageNo 起始页码 数字 默认1
pageSize 页容量 数字 默认、最大100
coopal 是否站外合作 数字 1:允许,0:禁止 不传默认都推送
注:keyWord、threeCategory需要URLEncoder处理
返回结果:参照专辑信息数据

10.根据url获取视频信息接口

接口说明:
      根据视频的url获取视频相应的信息。
请求形式:
      http://expand.video.iqiyi.com/api/fb?apiKey=
      http://expand.video.iqiyi.com/api/fb?apiKey=
例如: http://expand.video.iqiyi.com/api/fb?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&rec=0&playurl=http://www.iqiyi.com/v_19rrmmta60.html
参数说明:
参数名 说明 数据类型 是否必须 取值
apiKey apiKey 字符串  
playurl 视频地址 字符串  
rec 查询视频内容 字符串 默认会推出与此视频相关视频信息,取值为0取当前视频信息
返回结果:
节点 说明 备注
title 视频名称
url 视频地址
Swf 分享播放器地址
imghUrl 图片地址
duration 时长
updateTime 描述
playNum 播放次数
tag 标签
vid VID
tvId 视频id 废弃(qipuId代替)
qipuId 视频的奇谱id
albumId 专辑id 废弃(albumQipuId代替)
albumQipuId 专辑的奇谱id
categoryId 频道id
copyrightId 版权id
mainActors 主持人

二、相关问题说明

1. openApi推送ugc数据

推送UGC说明
增加UGC的Openapi的数据查询功能, 涉及以下查询功能:
      a) 视频信息接口
      根据视频ID查询视频详细信息。
      实现功能:
            根据视频ID(如果是ugcID)查询ugc视频的详细信息接口,支持根据Id查询一周以内的某条视频的详细信息。
      请求形式:
      http:///api/video/info.json?apiKey=&qipuId=
      例如:
      http://expand.video.iqiyi.com/api/video/info.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&qipuId=2169800709
      参数说明:与视频信息接口相同
      返回结果:与视频信息接口相同
      b) 根据更新时间查询视频接口
     查询某个时间段内更新的视频信息。
     实现功能:
          1、视频增量接口中显示ugc数据,十万级别的增量数据在分页查询中没有和之前有明显的差异;
          2、增加数据类型标识(dataType),需要ugc数据和需要pgc数据以及pgc&ugc数据都需要,可以通过该字段来控制,方便用户的数据需求;
     请求形式:
     http:///api/video/list.xml?apiKey=&startTime=&endTime=&pageNo=&pageSize =
     例如:
     http://expand.video.iqiyi.com/api/video/list.json?apiKey=71c300df4a7f4e89a43d8e19e5458e6f&startTime=20140520000000&endTime=20140522000000&dataType=all
     参数说明:添加了一个新的参数dataType,这个参数用来控制数据的推送类型,不是必须的参数,默认推送pgc数据;参数值为ugc时只推送UGC数据;参数值为all时所有的数据混推,pgc数据在前,ugc数据在后。其他参数保留了以前的。
     返回结果:与原来的返回结果保持一致

2.常见问题汇总

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,可以在站外嵌套播放。
    注:若不存在该平台,则该平台视为下线。

北京爱奇艺科技有限公司

公司介绍 新闻动态 联系方式 招聘英才 爱奇艺实验室 开放平台 爱奇艺号认证 爱奇艺号 帮助中心 侵权投诉 About Us

Copyright © 2017 爱奇艺 All Rights Reserved