多条节目详细信息

1. 接口描述

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

2. 系统参数

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

参数名 参数全称 必选 参数类型 参数描述
q query true String q=showid:$showid
fd field true String fd为一系列字段,详见注意事项部分.

4. 返回参数

最后收录正片的集号(不计算屏蔽、未锁定、不显示的视频)
参数名 参数全称 必选 参数类型 参数描述
copyright_status copyright_status true String 版权状态,具体见注意事项部分。
state state true String 节目状态,具体见注意事项部门
douban_num douban_num true String 豆瓣(douban)对应节目编号
showtotal_down showtotal_down true String 节目总“踩”数
showtotal_up showtotal_up true String 节目总“顶”数
series series true String 所属系列名称
seriesid seriesid true String 所属系列名称
showseq showseq true String 节目在所属系列
pay_type pay_type true String[] 付费类型:支持点播(vod) 支持包月(mon)
price price true String 节目价格(单位:分)
permit_duration permit_duration true String 消费期(收费节目)(天)
offlinetime offlinetime true String 节目下线时间(YYYY-MM-DD HH:NN:SS),查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSS
onlinetime onlinetime true string 节目上线时间(YYYY-MM-DD HH:NN:SS),查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSS
teacher teacher true String[] 主讲教师
composer composer true String[] 作曲
lyricswriter lyricswriter true String[] 作词
singer singer true String[] 演唱者
voice voice true String[] 配音
tv_station tv_station true String[] 电视台
host host true String[] 主持人
original original true String 原著
performer performer true String 演员
producer producer true String[] 出品人
screenwriter screenwriter true String[] 编剧
director director true String[] 导演
starring starring true String[] 主演
production production true String[] 制作公司
distributor distributor true String[] 发行公司或出品方,查寻时使用公司名称,结构:[{id:1001,name:“博纳影业”}]
showtotal_fav showtotal_fav true String 节目总收藏数
showtotal_comment showtotal_comment true String 节目总评论数
showweek_vv showweek_vv true String 节目一周播放总数(从当天向前推7天)
showday_vv showday_vv true String 节目一天播放总数(从“前天”开始计算,实际为24-48小时的数据)
showdesc showdesc true String 简介
site site true String[] 授权网站:youku(优酷) tudou(土豆),大部分节目,应该两个网站都支持
showcategory showcategory true String 节目主分类: 电影 电视剧 动漫 音乐 综艺 体育 教育 纪录片 资讯
releasedate_youku releasedate_youku true String 优酷发行时间(YYYY-MM-DD)
showcreatetime showcreatetime true String 节目创建时间(YYYY-MM-DD HH:NN:SS)
releasedate_mainland releasedate_mainland true String 大陆发行时间(YYYY-MM-DD)
releasedate releasedate true String 节目发行时间(YYYY-MM-DD)
reputation reputation true String 好评(0~10)
hasvideotype hasvideotype true String[] 包含的视频类型。正片,预告片,花絮,普通视频,资讯,MV,首映式,伪正片。不包含屏蔽视频、不显示视频和未锁定视频
showtotal_vv showtotal_vv true String 节目总播放数
update_notice update_notice true String 更新预告,如“每周四更新两集”
video_collected video_collected true int 节目收集所有视频总数(含正片和周边)
episode_last episode_last true String
episode_total episode_total true String 正片总集数
area area true String[] 节目国家地区
news_genre news_genre true String[] 资讯类型,仅限资讯
doc_genre doc_genre true String[] 纪录片类型,仅限纪录片
anime_genre anime_genre true String[] 动漫类型,仅限动漫
edu_genre edu_genre true String[] 教育类型,仅限教育
tv_genre tv_genre true String[] 电视剧类型,仅限电视剧
variety_genre variety_genre true String[] 综艺类型,仅限综艺
sports_genre sports_genre true String[] 体育类型,仅限体育
movie_genre movie_genre true String[] 电影类型,仅限电影
mv_genre mv_genre true String[] 音乐风格,仅限音乐
streamtypes streamtypes true String[] 正片拥有的流格式(详细见注意事项部分)。规则:正片收录完成, 并且全部正片都有 节目才算这个有这个流格式
showid showid true String 节目ID,16进制小写, 例如75a63cd2b9a2489d3c1e
showname showname true String 节目名称
paid paid true int 是否是收费节目。 0 - 免费 1 - 收费
pay_type pay_type true String[] 付费类型:支持点播(vod) 支持包月(mon)
showsubtitle showsubtitle true String 节目子标题
showalias showalias true String[] 节目别名 结构:[{'type':1,'alias':'KongFu Panda'},{…}],type:0中文 1英文

5. 调用示例

https://openapi.youku.com/router/rest.json?fd=video&opensysparams
={"format": "json", "action": "youku.content.program.multi.deltail.get", 
"access_token": "d9ce66ced641240836cf6011a4c195bc", 
"client_id": "163d4fd10c7f9a28", "version": "3.0", "timestamp": 1453718422,
"sign": "aa35367ab063886b9099f94329d27ed2"}&q=showid:301983,301984&caller=NOVA
            

6. 响应示例

{
tokens: "showid:30595",
orderby: "",
offset: 1,
total: 1,
index_cost: 0,
results: [
{
reputation: 8.659,
update_notice: null,
showname: "如果爱",
showsubtitle: "陈可辛打造爱情音乐剧",
pk_odshow: "30595",
state: "normal",
site: [
"youku",
"tudou"
],
copyright_status: "authorized",
releasedate: "2005-12-01",
releasedate_mainland: "0000-00-00",
releasedate_youku: "0000-00-00",
onlinetime: "0000-00-00 00:00:00",
offlinetime: "0000-00-00 00:00:00",
pay_type: [ ],
douban_num: "1418070",
showcategory: "电影",
hasvideotype: [
"预告片",
"正片"
],
streamtypes: [
"hd2",
"flvhd",
"hd",
"mp5hd",
"mp5hd2"
],
showcreatetime: "2009-08-31 19:58:23",
id: 30595,
showseq: 0,
seriesid: 0,
price: 0,
permit_duration: 0,
showtotal_down: 288,
showtotal_up: 4891,
showtotal_fav: 1393,
showtotal_comment: 522,
showweek_vv: 9227,
showday_vv: 1607,
showtotal_vv: 1791236,
video_collected: 2,
episode_last: 1,
episode_total: 1,
paid: 0,
movie_genre: [
"剧情",
"爱情",
"歌舞",
"文艺"
],
tv_genre: [ ],
anime_genre: [ ],
mv_genre: [ ],
area: [
"大陆",
"香港",
"马来西亚"
],
variety_genre: [ ],
sports_genre: [ ],
edu_genre: [ ],
news_genre: [ ],
doc_genre: [ ],
showid: "cc07434e962411de83b1",
series: null,
showdesc: "想演戏的孙纳(周迅 饰)与想导戏的林见东(金城武 饰)初遇见时,两人都正处于生活与事业的低谷,在相互鼓励和扶携中,他们渐渐有了共同的可以看见希望的未来,然而孙纳更想把现在的可能抓到手,狠心与林见东分了手,跟了可以给她戏的导演聂文(张学友 饰),成为人人艳羡的大明星。   天意弄人,十年后孙纳与也做了演员的林见东因为一部合拍戏又重遇。虽努力说服自己忘记过去,却欺骗不了自己的心,孙纳陷入两难中。而更戏剧的是,孙纳、林见东和聂文要同演一出剧情与他们之间情恨纠葛惊人相似的戏。",
showalias: [
{
type: "0",
alias: "如果·爱"
},
{
type: "0",
alias: "毋忘我"
},
{
type: "0",
alias: "勿忘我"
},
{
type: "1",
alias: "Perhaps Love"
}
],
show_thumburl: "http://r2.ykimg.com/050B0000522422676758396219046C80",
director: [
{
id: "59725",
name: "陈可辛",
thumburl: "http://r1.ykimg.com/05130000532AA31667379F188508C57D"
}
],
performer: [
{
id: "17344",
name: "周迅",
thumburl: "http://r4.ykimg.com/051300004F96446F9792737BD50C5180",
character: [
"孙纳"
]
},
{
id: "13945",
name: "金城武",
thumburl: "http://r3.ykimg.com/05130000540FE51A67379F10B90772D2",
character: [
"林见东"
]
},
{
id: "12148",
name: "张学友",
thumburl: "http://r3.ykimg.com/051300004E9D42FF979273023B04E4B0",
character: [
"聂文"
]
},
{
id: "11730",
name: "曾志伟",
thumburl: "http://r2.ykimg.com/051300004EC5D01F9792732A9D083A56",
character: [
"制片人"
]
},
{
id: "16336",
name: "池珍熙",
thumburl: "http://r1.ykimg.com/0513000050DA757D979273460D03F4EA",
character: [
"Monty"
]
},
{
id: "12222",
name: "吴君如",
thumburl: "http://r3.ykimg.com/051300004E7952B497927336F2043586",
character: [
"林见东经纪人"
]
}
],
screenwriter: [
{
id: "104347",
name: "林爱华",
thumburl: "http://r1.ykimg.com/05130000533E260A67379F17AB0E016E"
},
{
id: "99039",
name: "杜国威",
thumburl: "http://r3.ykimg.com/051300004F7FC8119792732A2A078B26"
}
],
producer: [
{
id: "59725",
name: "陈可辛",
thumburl: "http://r1.ykimg.com/05130000532AA31667379F188508C57D"
},
{
id: "63306",
name: "安德鲁·摩根",
thumburl: "http://r3.ykimg.com/051300004EB3A6F197927317E0087EBD"
},
{
id: "369283",
name: "安晓芬",
thumburl: "http://r2.ykimg.com/05130000517B26559792731EBC059786"
}
],
distributor: [
{
id: "10410",
name: "天映娱乐",
type: "distributor"
},
{
id: "14156",
name: "甲上娱乐有限公司",
type: "distributor"
},
{
id: "31980",
name: "Wild Side Films",
type: "distributor"
}
],
production: [
{
id: "14156",
name: "甲上娱乐有限公司",
type: "production"
},
{
id: "20794",
name: "Ruddy Morgan Productions",
type: "production"
},
{
id: "49382",
name: "Morgan & Chan Films",
type: "production"
}
]
}
],
_errorCode: 0,
_errorDesc: null,
url_cost: 0.0055370330810547,
batch_url_cost: 0,
total_cost: 0.029845952987671
}
            

7. 异常示例

8. 注意事项

(1)fd可选参数包括:

series showseq seriesid pay_type price permit_duration offlinetime onlinetime teacher composer

lyricswriter singer voice tv_station host original performer starring producer screenwriter director

copyright_status state production distributor douban_num showtotal_down showtotal_up showtotal_fav

showtotal_comment showweek_vv showday_vv showdesc site showcategory releasedate_youku showcreatetime

releasedate_mainland releasedatereputation hasvideotype showtotal_vv update_notice video_collected

doc_genre anime_genre edu_genre sports_genre tv_genre variety_genre movie_genre mv_genre streamtypes showid

showname paid pay_type showsubtitle showalias show_thumburl episode_last episode_total area news_genre

(2)版权状态

authorized 已授权, public 公共版权, falseauth 伪授权,unknow 版权未知, expired 版权过期, unauthorized 无版权

(3)节目状态

normal - 正常 limited - 分级 check - 待审 checking- 审核 blocked - 屏蔽 deleted - 删除 delayed - 延审 paycheck - 付费待审

(4)正片拥有的流格式

fileid flvhd flv hd(mp4hd) 3gp 3gphd hd2(720p)(mp4hd2) hd3(mp4hd3)(1080p) mp5sd mp5hd mp5hd2 mp5hd3 mp5hd4